Plug-Ins mit einem WordPress-Theme benötigen oder empfehlen

WordPress kann mit seiner umfangreichen Sammlung von Plug-Ins in nahezu jede Art von CMS integriert werden, die Sie sich vorstellen können. Es gab jedoch ein wiederkehrendes Problem für Autoren von WordPress-Themes, wenn es darum ging, die Leistung dieser Plug-Ins zu nutzen: Wie benötige oder empfehle ich diese Plug-Ins für mein Thema?

Während Sie Ihre Benutzer jederzeit dazu ermutigen können, das WordPress-Plug-In-Repository zu besuchen oder ihnen Schritt für Schritt Anweisungen zum Installieren und Aktivieren von Plug-Ins zu geben, wäre es nicht großartig, Ihren Benutzern eine nahtlose Plug-In-Integration direkt bereitzustellen in dein Thema? Zusammen mit meinem Freund Gary Jones Wir haben uns entschlossen, dieses Problem direkt anzugehen und den Autoren von WordPress-Themes eine genaue Kontrolle über die Aufnahme von Plug-Ins in WordPress-Themes zu geben. Unsere Zusammenarbeit brachte eine leistungsstarke PHP-Bibliothek für WordPress hervor TGM-Plug-In-Aktivierung . Im Folgenden werde ich Ihnen zeigen, wie Sie die TGM-Plug-In-Aktivierung in Ihren WordPress-Themes verwenden können, um die Leistung aller WordPress-Plug-Ins im Web zu nutzen.

Herunterladen und Installieren der TGM-Plug-In-Aktivierung

Das Herunterladen und Installieren der TGM-Plug-In-Aktivierung ist relativ einfach. Wenn Sie zuvor ein WordPress-Theme erstellt haben, ist die Integration ein Kinderspiel. Befolgen Sie einfach die nachstehenden Anweisungen, um loszulegen.



  1. Besuchen Sie die TGM-Plug-In-Aktivierung Website und laden Sie eine Kopie.
  2. Platzieren Sie die Klassendatei irgendwo in Ihrer Themenhierarchie (das Stammverzeichnis ist immer ein guter Ausgangspunkt).
  3. Kopieren Sie den Inhalt der example.php Datei in Ihre functions.php Datei und ändern Sie, um Ihren Bedürfnissen zu entsprechen.

Einfach richtig? Hier ein paar Notizen und Screenshots, die Ihnen helfen sollen, falls Sie nicht weiterkommen:

  1. Stellen Sie sicher, dass Sie den richtigen Pfad zur Datei in der Datei angeben einmalig benötigt Anruf (Sie müssen es möglicherweise ändern, je nachdem, wo Sie es in Ihrem Thema platzieren).
  2. Plug-Ins, auf die aus dem offiziellen WordPress-Plug-In-Repository verwiesen wird, benötigen das Quellargument nicht. Nur vorgefertigte oder private Repo-Plug-Ins benötigen das Quellargument.
  3. Das $ config Die Variable enthält viele Informationen zum Anpassen der Klasse, einschließlich Klassenzeichenfolgen. Aktualisieren Sie diese entsprechend Ihren Anforderungen.

Schauen Sie sich die folgenden Screenshots an, um ein Beispiel zu sehen, wie ich die Klasse und einige Plug-Ins in das Standard-WordPress TwentyEleven-Thema aufgenommen habe:

wie man ein Flip-Phone benutzt

Ein tieferer Blick auf die Konfigurationsoptionen

Die TGM-Plug-in-Aktivierung verfügt über eine benutzerfreundliche API, die sich nahtlos in WordPress integrieren lässt. Verwendung der Funktion tgmpa () Die Bibliothek registriert Plug-Ins mit Ihrem Thema und zeigt sie mit den entsprechenden Optionen an. Lassen Sie uns einen genaueren Blick darauf werfen, wie die Bibliotheks-API tatsächlich funktioniert. Jedes Plug-In kann eine Reihe von Parametern annehmen, wie unten angegeben:

  • Name : Der Name des Plug-Ins.
  • Schnecke : Der Plug-In-Slug, der normalerweise der Name des Ordners ist, in dem sich das Plug-In befindet.
  • erforderlich : Entweder wahr oder falsch . Wenn true festgelegt ist, ist das Plug-In 'erforderlich'. Bei false wird das Plug-In empfohlen.
  • Quelle : Die Quelle des Plug-Ins. Dieser Parameter ist erforderlich, wenn das Plug-In, auf das Sie verweisen, nicht aus dem WordPress-Plug-In-Repository stammt. Über diesen Parameter können Sie entweder auf vorgefertigte Plug-Ins oder auf Plug-Ins an anderer Stelle im Internet verweisen.
  • Ausführung : Die für das Plug-In erforderliche Mindestversion. Dieser Parameter ist nützlich, wenn Sie eine Mindestversion eines Plug-Ins benötigen, damit Ihr Thema funktioniert. Wenn der Benutzer das Plug-In installiert hat, aber die angegebene Mindestversion nicht erfüllt, wird er aufgefordert, das Plug-In auf die neueste Version zu aktualisieren.
  • force_activation : Entweder wahr oder falsch . Wenn true festgelegt ist, wird das angegebene Plug-In jederzeit aktiv, solange das aktuelle Thema aktiv ist. Das Plug-In kann nur durch Themenwechsel deaktiviert werden.
  • force_deactivation : Entweder wahr oder falsch . Wenn true festgelegt ist, wird das angegebene Plug-In beim Umschalten des aktuellen Themas deaktiviert. Dies ist nützlich, um themenspezifische Plug-Ins zu deaktivieren.
  • external_url : Eine externe URL für das Plug-In. Standardmäßig werden Plug-Ins, auf die aus dem WordPress-Plug-In-Repository verwiesen wird, über Thickbox mit ihren Plug-In-Informationen verknüpft. Dieser Parameter überschreibt dieses Standardverhalten und ermöglicht es Ihnen, eine beliebige URL für das Plug-In anzugeben.

Die Bibliothek verfügt außerdem über eine Reihe von Konfigurationsoptionen, die Sie auf globaler Ebene bearbeiten können, wie unten angegeben:

  • Domain : $ theme_text_domain - Die Textdomäne für übersetzbaren Text. Sie möchten dies wahrscheinlich auf dieselbe Textdomäne wie Ihr Thema oder Plug-In festlegen.
  • Standardpfad : Der absolute Standardpfad für vorgefertigte Plug-Ins.
  • parent_menu_slug : Der übergeordnete Menü-Slug für die Plug-In-Installationsseite. Dies ist nützlich, wenn Sie die Plug-In-Installationsseite unter einer benutzerdefinierten Admin-Menüseite platzieren.
  • parent_menu_url : Die übergeordnete Menü-URL für die Plug-In-Installationsseite. Der URL-Slug zum Verweisen auf Ihre Plug-In-Installationsseite.
  • Speisekarte : Der Menü-Slug für die Plug-In-Installationsseite. Der Slug für die eigentliche Plug-In-Installationsseite sieht standardmäßig folgendermaßen aus: ? page = install-required-plugins
  • has_notices: Entweder wahr oder falsch . Wenn dies der Fall ist, werden Administratorhinweise für erforderliche / empfohlene Plug-Ins angezeigt.
  • is_automatic: Entweder wahr oder falsch . Wenn dies der Fall ist, werden Plug-Ins nach erfolgreicher Installation automatisch aktiviert (sowohl für Einzel- als auch für Masseninstallationsprozesse).
  • Botschaft : Optionaler HTML-Inhalt, der vor der Ausgabe der Plugins-Tabelle eingeschlossen werden soll. Dies wird gefiltert durch wp_kses_post () .
  • Saiten : Ein Array anpassbarer Zeichenfolgen, die in der gesamten Bibliothek verwendet werden. Zeichenfolgen mit dem Präfix _n_noop () haben sowohl Singular- als auch Pluralformen (in dieser Reihenfolge).

Beginnen Sie zu sehen, wie leistungsfähig diese Bibliothek sein kann? Wenn Sie die Bibliothek in Ihrem Thema erfolgreich eingerichtet und auf alle gewünschten Plug-Ins verwiesen haben (ich habe gesehen, wie die Masseninstallationsfunktion 112 Plugins gleichzeitig installiert hat, also viel Spaß!), Aktivieren Sie Ihr Thema. Sie sehen einen Bildschirm ähnlich dem folgenden:

Final Cut Pro X Systemanforderungen

Sie werden mit einer nahtlos integrierten Administratorbenachrichtigung begrüßt, die besagt, dass Sie alle Plug-Ins installieren sollten, die Sie in Ihr Thema aufgenommen haben. Die Bekanntmachungen sind in vier Teile gegliedert:

  1. Erforderlich und nicht installiert.
  2. Empfohlen und nicht installiert.
  3. Erforderlich, installiert, aber nicht aktiviert.
  4. Empfohlen, installiert, aber nicht aktiviert.

Der Hinweis enthält Aktionslinks (die gefiltert werden können), um Benutzer zu ermutigen, mit der Installation oder Aktivierung der Plug-Ins zu beginnen. Dadurch gelangen sie zu der von Ihnen angegebenen Seite (standardmäßig auf der Registerkarte 'Darstellung'), auf der sie mit einer Tabellenliste von Plug-Ins und Aktionslinks interagieren können. Diese Integration fügt sich nahtlos in die native WordPress-Benutzeroberfläche ein und sollte Ihren Benutzern ein sehr vertrautes Aussehen geben. Wenn Sie auf einen dieser Links klicken, gelangen Sie zu einem Bildschirm, der wie folgt aussieht:

Die Plug-Ins werden in der Tabelle mit verschiedenen Informationen für jedes Plug-In angezeigt. Jedes Plug-In verfügt über Hover-Aktionslinks, die auf dem aktuellen Status basieren (wenn das Plug-In beispielsweise installiert, aber nicht aktiviert ist, wird beim Hover ein Link 'Aktivieren' angezeigt). Eine der großartigen Funktionen der TGM-Plug-In-Aktivierungsbibliothek besteht darin, dass Sie die Plug-Ins in großen Mengen installieren oder aktivieren können. Zum Beispiel, wenn Sie die is_automatic $ config Option auf true, Ihre Benutzer könnten alle Plug-Ins auf einmal auswählen, sie in großen Mengen installieren und sie werden alle automatisch aktiviert, sobald sie installiert sind! Auch die Schnittstelle für Installationen und Aktivierungen lässt sich nahtlos in den WordPress-Administrator integrieren. Betrachten Sie den folgenden Screenshot für die Masseninstallation einer ausgewählten Gruppe von Plug-Ins:

Ähnlich aussehend? Es sollte! Es folgt genau dem gleichen Muster wie Plugins zur Massenaktualisierung innerhalb des WordPress-Administrators!

wie man ein Bild im Illustrator bearbeitet

Fazit

Die Vorteile der Verwendung der TGM Plug-in-Aktivierungsbibliothek sind enorm. Sie müssen nicht mehr all diese zusätzlichen Funktionen in Ihr Thema integrieren, nur weil Sie keine Möglichkeit gefunden haben, ein Plug-In aus dem WordPress-Plugin-Repository aufzunehmen - diese Bibliothek macht es zum Kinderspiel! Wie bei jeder Software gibt es immer Raum für Verbesserungen. Das Projekt wird auf Github gehostet, wo Sie es kostenlos herunterladen und an Ihre Bedürfnisse anpassen können. Sollten Sie Probleme finden oder Verbesserungsvorschläge haben, besuchen Sie die Seite mit den Github-Problemen und veröffentlichen Sie sie dort, damit Gary und ich sie dokumentieren und (möglicherweise) in zukünftige Versionen einarbeiten können. Haben Sie die TGM-Plug-In-Aktivierung in einem Ihrer WordPress-Themes (oder sogar Plug-Ins) verwendet? Ich würde es gerne wissen!