Social Links

Mit dem Modul „Social Links“ können Benutzer Profil-Links bestimmter mit Publizieren verbundener Dienste für die Social Media Integration ihres Themes auswählen.

Um diese Funktion nutzen zu können, musst du

• Theme-Unterstützung mit der Funktion add_theme_support() in deinem Theme hinzufügen.
• die Theme Modifications API verwenden, um die Daten in das Template deines Themes zu ziehen.

Unterstützung hinzufügen

Durch die Verwendung von add_theme_support() ist die Aktivierung von „Social Links“ so ähnlich wie das Hinzufügen der Unterstützung von Vorschaubildern oder Editor Styles. Da beim Aufruf von add_theme_support() ein Array mit Slugs der unterstützten Dienste als zweites Argument bereitgestellt wird, gibt „Social Links“ genau die Information weiter, die dein Theme benötigt. „Social Links“ unterstützt derzeit fünf Dienste: Facebook, Twitter, LinkedIn, Google+ und Tumblr. Da jedes Theme unterschiedlich ist und einige Themes eventuell nicht alle Dienste unterstützen, muss dies im Theme festgelegt werden:

add_theme_support( 'social-links', array(
    'facebook', 'twitter', 'linkedin', 'google_plus', 'tumblr',
) );

Nutzung der Information

„Social Links“ macht die Information durch die Theme Modifications API verfügbar. Auf diese Weise können Themes die Information über get_theme_mod() aufrufen und damit arbeiten. Als Theme-Entwickler solltest du vor der Nutzung immer überprüfen, ob der Benutzer tatsächlich einen Link für diesen Dienst festgelegt hat. Du kannst auf die Standardwerte des Kerns für false vertrauen oder einen leeren String als zweites Argument weitergeben, wenn du mit konsistenten Datentypen arbeiten möchtest. Wir haben dem Namen der Theme-Modifikation „jetpack" vorangestellt, um keiner anderen Plugin- oder Themefunktion in die Quere zu kommen, die möglicherweise denselben Service-Name verwendet. So könnte die Implementation in eine Template-Datei nach Überprüfen, ob die URL festgelegt wurde, aussehen:

<a href="<?php echo esc_url( get_theme_mod( 'jetpack-facebook' ) ); ?>">
    <?php _e( 'Facebook', 'textdomain' ); ?>
</a>

Beachte bitte, dass die Daten, obwohl sie über get_theme_mod()verfügbar sind, tatsächlich als serialisierte Werte in den Jetpack Optionen gespeichert werden und nicht als Theme Mod. Wir passen lediglich einige Filter im Hintergrund an, um Entwicklern den Zugang mit get_theme_mod() zu vereinfachen, so dass du keine benutzerdefinierten Funktionen verwenden musst, die abgebrochen werden könnten, wenn deine Benutzer Jetpack nicht installiert haben!