Ab und an gibt es aber Fälle, da möchte man im Template den Shortcode nutzen oder die Daten nicht im Editor pflegen, sondern via Custom Field oder ähnliches mitgeben. Kennt man oder gibt es dafür eine Funktion im Plugin oder der Erweiterung für WordPress, dann kann man dies aber trotzdem nutzen. Eine Funktion von WordPress für den Zugriff auf Shortcodes hilft.

Der einfachste Fall ist der Zugriff auf einen Shortcode, bspw. myshortcode; erfolgt mittels der Funktion do_shortcode(). Ein Code-beispiel dazu soll es verdeutlichen; abgelegt wird es im Template - bspw. die single.php des Themes.

echo do_shortcode('[myshortcode]');

Wenn man mit Parametern arbeitet; heißt, der Shortcode kann diese Parameter verarbeiten, dann kann man diese einfach mitgeben.

echo do_shortcode('[myshortcode param="blahblahblah"]');

Aufpassen: PHP unterscheidet ' und ", daher kann es beim Laien zu Problemen kommen. Zum Beispiel würde der folgenden Aufruf nicht klappen:

echo do_shortcode('[myshortcode param='blahblahblah']');

übersichtlich und funktionierend wäre

echo do_shortcode('[myshortcode param="blahblahblah"]');

Ein weiters Beispiel nutze aus dem benutzerdefinierten Feld example-name den Wert und übergibt dies an den Shortcode example_shortcode für den Parameter product.

<?php
$example_product = get_post_meta( $post->ID, 'example-name', $single = true );
if ($example_product)
	echo do_shortcode('[example_shortcode product="' . $example_product . '"]');
?>

Daraus ergeben sich viele Möglichkeiten, so zum Beispiel auch ein einfacher Zugriff auf die Gallery, die man pro Beitrag pflegt.

echo do_shortcode('[gallery option1="value1"]');

Damit kann man im Template einfach die Gallery laden und ist unabhängig von den Shortcodes im Editor. Nebenbei spart man sich das Parsen des Filters und beim neuen Design, wenn die die Bilder wenig relevant sind, kann man diese einfach weg lassen und muss nicht den Content filtern oder den Editor vieler Beiträge bemühen. Alle weiteren Ideen überlasse ich gern euch.

© Frank Bültge, All rights reserved / Alle Rechte vorbehalten. (ID: 6e8b33de4342c4f2ca76b245199aeee8)

Danke für das Abonnieren meines Feed! Inhalt gefällt? Danke sagen · Kommentieren

Rechte-Abfrage

Eine einfache Möglichkeit ist die Abfrage der Rechte - die WordPress-Funktion current_user_can() erlaubt dies und kann einfach in Templates des Themes verwendet werden. Somit kann man steuern, dass nur geloggte User mit den entsprechenden Rechten den Inhalt sehen.
Im einfachsten Fall könnte man dies wie folgt im Template einbauen:

if ( current_user_can( 'manage_options' ) )
	the_content( the_title( '', '', false ) . ' ' . __( 'weiterlesen »', FB_BASIS_TEXTDOMAIN ) );
else
	_e( 'Nur für geloggte User zugänglich', FB_BASIS_TEXTDOMAIN );

Ohne die einzelnen Rechte abzufragen genügt die Abfrage mittels der Funktion is_user_logged_in(). Damit wird geprüft, ob der User geloggt ist.

Hier gibt es sicher diverse Ansätze und Möglichkeiten, die aber leicht nutzbar sind und trotzdem die unterschiedlichen Rollen und Objekte berücksichtigen. Die Objekte je Rolle sind übersichtlich im Codex beschrieben.

Prüfung auf Login via Funktion

Nun ist die Integration im Template recht einfach, sorgt aber dafür dass man in der Regel jedes Template anpassen muss. Da WordPress mit Hooks arbeitet, kann man hier auch einhaken und zentral via Plugin oder functions.php im Theme eine Funktion dafür ablegen.

Die folgende Funktion ist so ein Beispiel und prüft in dem Fall unabhängig von den Rechten, sondern lediglich ob der User geloggt ist - wenn ja, dann darf der Inhalt gesehen werden. Über den Hook the_content wird hier zentral gesteuert - so dass die Ausgabe im Theme, welche via dem Template Tag the_content() kommt, nur dann den Content wieder gibt, wenn man als User geloggt ist.
Parallel wurde hier auch explizit im Feed nur ausgegeben, wenn man geloggt ist - !is_feed().

Als Alternative für nicht geloggte User wird ein Abschnitt des Content ausgegeben - dazu gibt es verschieden Ansätze, hier wurde explizit mit Zeichen gearbeitet. So entsteht quasi ein Teaser für den Leser.

function content_only4logged_in($content) {

	// alle geloggten User
	if ( is_user_logged_in() &&
			!is_null($content) &&
			!is_feed()
		 ) {

		return $content;
	} else {

		$content  = wp_html_excerpt( $content, 80 );
		$content .= ' …';
		$content .= __( 'Sorry, more of this content is only available for logged users.', FB_TEXTDOMAIN );
		return $content;
	}
}
add_action( 'the_content', 'content_only4logged_in' );

Inhalte via Shortcode einschränken

Eine weitere Alternative ist es, nur einen bestimmten Abschnitt des Content nur für geloggte User frei zu geben. Dies könnte man beispielsweise über die Shortcode-API von WordPress tun. Auch dazu ein Beispiel. Hier wird der Shortcode [member] eingesetzt. Alles innerhalb dieses Elementes ist nur für geloggte User sichtbar.
Auch dieser Code gehört in ein Plugin oder die Schnittstelle des Themes für neue Funktionen.

function fb_check_logged_in( $atts, $content = null ) {
	if ( is_user_logged_in() &&
		!is_null($content) &&
		!is_feed()
		 ) {

		return $content;
	} else {

		return __( 'Sorry, this content is only available for logged users.', FB_TEXTDOMAIN );
	}
}
add_shortcode( 'member', 'fb_check_logged_in' );

Zeitabhängig ausgeben

Eine denkbare Alternative ist auch das Ausgeben von Inhalten nach einem bestimmten Zeitraum. Diese Möglichkeit kann sicher beliebig erweitert werden. So lohnt sicher die Erweiterung um eine Metabox zur Eingabe eines Datums an den Beiträgen oder Erweiterung von Parametern um den Zeitrahmen in einem Shortcode abzufragen.

function content_only4time($content) {

	$date = strtotime( '01-10-2010' ); // day-month-year
	$now  = strtotime( date('d-m-Y') );
	echo $now . ' - ' . $date;
	if ( $date && ( $date < $now ) ) {

		return $content;
	} else {

		return __( 'Sorry, die Zeit ist noch nicht reif.', FB_TEXTDOMAIN );
	}
}
add_action( 'the_content', 'content_only4time' );

In diesem Zusammenhang kann das Plugin wpSleep genutzt werden, welches via Shortcode und den Parametern der Zeit die Ausgabe steuert.

Mehr

Die Liste der Ansätze und vor allem der Möglichkeiten lässt sich beliebig fort führen - mit den Möglichkeiten kommt man eventuell auf eigene Ideen und kann die aufgezeigten Ansätze nutzen. Gern können weitere Ideen und Möglichkeiten in den Kommentaren untergebracht werden.

© Frank Bültge, All rights reserved / Alle Rechte vorbehalten. (ID: 6e8b33de4342c4f2ca76b245199aeee8)

Danke für das Abonnieren meines Feed! Inhalt gefällt? Danke sagen · Kommentieren

Pro Artikel hinterlegt der Autor drei benutzerdefinierte Felder, in einem weiteren Artikel schon mal näher erläutert: bild, link, linktext. Im Text kann er den Shortcode [werbung] setzen. Diesen erkennt WordPress und mit Hilfe der folgenden Funktion werden die entsprechenden Daten geladen und die Werbung wir dann an dieser Stelle eingebunden.

Die folgende Funktion kann als Plugin oder in der functions.php des Themes abgelegt werden.

function example_link() {
	global $wp_query;

	$postID     = $wp_query->post->ID;
	$mylink     = get_post_custom_values('link', $postID);
	$mypic      = get_post_custom_values('bild', $postID);
	$mylinktext = get_post_custom_values('linktext', $postID);

	return '<a href="' . $mylink[0] . '"><img title="' . $mylinktext[0] . '" src="' . $mypic[0] . '" alt="" /></a>';
}

add_shortcode('werbung', 'example_link');

Im Text erscheint nun auf recht einfache Weise das Bild mit Link und Linktext. Die Lösung zeigt nur einen Lösungsweg und kann sicher in der einen oder anderem Form Anwendung finden. Trotzdem sollte man überlegen, wie man die Shortcodes nutzen will und die Funktion darauf hin anpassen. Ähnlich könnte auch die Daten für Link, Bild, und Linktext aus anderen Datenfeldern kommen, die Shortcode-API erleichtert es aber, dass Autoren derartige Inhalte in den Artikel einbinden können.

© Frank Bültge, All rights reserved / Alle Rechte vorbehalten. (ID: 6e8b33de4342c4f2ca76b245199aeee8)

Danke für das Abonnieren meines Feed! Inhalt gefällt? Danke sagen · Kommentieren

Die Möglichkeiten von Shortcodes sind vielfältig, viele andere Applikationen lieben diese Funktion und mit der neuen Funktionalität kann man dem Kunden das Schreiben im Backend damit recht gut erleichtern. Um die Shortcodes noch in das Quicktag-Menu zu bekommen, empfiehlt sich die Verwendung des Plugin AddQuicktag.

Die Übergabe ist einfach und schnell verstanden. Eine kleine Einführung und ersichtliche Erfolge gibt es in Kurzversion in den folgenden Zeilen. Wie es genau geht und ein Plugin mit verschiedenen Beispielen gibt es bei Ozh, der derzeit auch die neue WordPress Funktion durchleuchtet.

Die Möglichkeiten

[shortcode ]
[shortcode /]
[shortcode foo="bar" /]
[shortcode foo="bar" baz="bing" /]
[shortcode ]content[shortcode /]
[shortcode foo="bar"]content[/shortcode]

Erläuterungen

In kurzen Zügen und als kleine Übersicht hier nun die Funktionsweise, verantwortlich ist die Funktion add_shortcode(). Näheres findet man in /wp-includes/shortcodes.php, inklusive einer „kleinen“ Dokumentation.

Das folgende Beispiel, in einem Plugin oder Theme hinterlegt, sorgt dafür, dass wenn der Syntax [tag1] im Content vergeben wird, dann erscheint im Frontend, auf das Blog also, der Text Some Longer Text.

// [tag1] --> Some Longer Text
function shortcode_example() {

	return 'Some Longer Text';
}

add_shortcode('tag1', 'shortcode_example');

Im Screenshot sollte das ganze dann deutlicher werden.

• Offizielle Dokumentation

© Frank Bültge, All rights reserved / Alle Rechte vorbehalten. (ID: 6e8b33de4342c4f2ca76b245199aeee8)

Danke für das Abonnieren meines Feed! Inhalt gefällt? Danke sagen · Kommentieren