Aternos ist eine Plattform für die Entwicklung und Verwaltung von Websites, die viele Möglichkeiten bietet, um die Funktionalität zu erweitern. Eine der wichtigsten und nützlichsten Möglichkeiten, Ihre Website anzupassen, ist das Hinzufügen eigener Plugins.
Plugins sind spezielle Module, die die Standardfunktionen von Aternos erweitern und neue Funktionen hinzufügen. Mit Plugins können Sie beispielsweise eine Bildergalerie, ein Kontaktformular hinzufügen oder Dienste von Drittanbietern in Ihre Website integrieren.
Um ein Plugin zu Aternos hinzuzufügen, müssen Sie zuerst die gewünschte Erweiterung auswählen und installieren. Dazu müssen Sie im Administrationsbereich Ihrer Website zum Abschnitt "Plugins" wechseln. In diesem Abschnitt finden Sie viele Plugins in verschiedenen Kategorien, wie z. B. Media-Plugins, Social-Media-Plugins, Analysen und vieles mehr.
Erstellen eines Ordners für das Plugin
Bevor Sie ein Plugin zu Aternos hinzufügen können, müssen Sie einen separaten Ordner für das Plugin erstellen. Dadurch wird es einfacher, die Struktur und das Speichern der Plugin-Dateien zu organisieren.
Befolgen Sie diese einfachen Schritte, um einen Ordner für das Plugin zu erstellen:
- Öffnen Sie den Datei-Explorer oder den Dateimanager auf Ihrem Computer.
- Wählen Sie den Ort aus, an dem Sie den Ordner für das Plugin erstellen möchten. Dies könnte beispielsweise der Ordner "plugins" im Stammverzeichnis von Aternos sein.
- Klicken Sie mit der rechten Maustaste auf den ausgewählten Speicherort und wählen Sie die Option Neuen Ordner erstellen aus.
- Geben Sie einen Ordnernamen für das Plugin ein. Es wird empfohlen, einen informativen Namen zu verwenden, der mit der Funktionalität des Plugins verknüpft ist.
- Drücken Sie die Eingabetaste, um einen Ordner zu erstellen.
Sie haben jetzt einen separaten Ordner für Ihr Plugin. Innerhalb dieses Ordners können Sie Dateien erstellen und ihre Struktur entsprechend den Anforderungen der Aternos-Plattform organisieren.
Stellen Sie sicher, dass Sie die Ordnerstruktur für das Plugin gut durchdacht haben, damit Sie die gewünschten Dateien bequem finden und darauf zugreifen können, während Sie mit dem Plugin arbeiten.
Vorbereiten der Dateistruktur
Sie müssen einen neuen Ordner für Ihr Plugin im Verzeichnis des Aternos-Servers erstellen. Dies kann normalerweise über einen von Ihrem Hosting-Provider bereitgestellten Dateimanager oder über einen FTP-Client erfolgen.
Der Ordnername muss eindeutig und sinnvoll sein, um Ihr Plugin leicht zu identifizieren. Es wird empfohlen, nur lateinische Buchstaben, Zahlen und Unterstriche im Ordnernamen zu verwenden.
Im neuen Plugin-Ordner sollten Sie die folgende Dateistruktur erstellen:
- plugin.yml - eine Datei, die Plugin-Informationen wie Titel, Version, Autor und andere Details enthält. Diese Datei ist für jedes Plugin erforderlich.
- src/ - der Ordner, der die Quelldateien Ihres Plugins enthält. Hier werden Sie den Code Ihres Plugins entwickeln und ändern.
- build/ - der Ordner, in den Ihr Plugin kompiliert wird. Dies ist wichtig, um das Plugin auf den Server herunterzuladen.
Alle Dateien und Ordner in der Struktur müssen über Lese- und Schreibberechtigungen verfügen, damit der Server sie erfolgreich herunterladen kann.
Nachdem Sie die richtige Dateistruktur erstellt haben, können Sie mit dem Erstellen eines Plugins für Aternos beginnen.
Schreiben der Hauptdatei des Plugins
Um die Hauptdatei des Plugins zu erstellen, müssen Sie eine neue Datei mit der Erweiterung erstellen. "php" und füge den folgenden Code hinzu:
In diesem Code müssen Sie die Plugin-Informationen durch die entsprechenden Werte ersetzen.
Nachdem Sie die Plugin-Informationen identifiziert haben, können Sie mit dem Schreiben Ihres Plugin-Codes beginnen. Sie können Funktionen, Hooks und Filter sowie jeden anderen Code hinzufügen, der in Ihrem Plugin benötigt wird.
Wenn Ihr Plugin einsatzbereit ist, speichern Sie die Datei und aktivieren Sie sie im Administrationsbereich von Aternos. Sobald das Plugin aktiviert ist, wird es in Ihrem Aternos-System funktionieren.
Plugin-Registrierung in Aternos
1. Erstellen Sie eine Datei mit der Erweiterung ".atp" und nennen Sie es so, dass es die Funktionalität Ihres Plugins widerspiegelt. Zum Beispiel: "Meineplagin.atp".
2. Öffnen Sie diese Datei in einem Texteditor, und fügen Sie den folgenden Code hinzu:
[atp] name=Mein Plugin version=1.0 author=Ihr Name description=Kurze Beschreibung des Plugins
Hier müssen Sie den Namen, die Version, den Autor und die Beschreibung Ihres Plugins angeben.
3. Fügen Sie als Nächstes in derselben Datei Codeblöcke hinzu, die die Funktionalität Ihres Plugins definieren. Zum Beispiel:
[atp-page] route=/plugin template=plugin.html
In diesem Beispiel definieren wir, dass beim Navigieren zu "/plugin" die Vorlage "Plugin" geladen werden muss.html". Sie können alle anderen Aktivitäten und Muster nach Ihren Bedürfnissen definieren.
4. Speichern Sie die Datei und laden Sie sie auf den Server hoch, auf dem Aternos installiert ist.
5. Führen Sie die folgenden Schritte aus, um Ihr Plugin in Aternos zu aktivieren:
- Öffnen Sie das Aternos-Admin-Panel.
- Rufen Sie die Seite "Plugins" auf.
- Suchen Sie Ihr Plugin in der Liste der verfügbaren Plugins und klicken Sie auf die Schaltfläche "Aktivieren".
Nach erfolgreicher Aktivierung wird Ihr Plugin aktiviert und kann in Aternos verwendet werden. Sie können es anpassen und seine Funktionalität auf Ihre Website oder Anwendung anwenden.
Hinzufügen von Einstellungen für das Plugin
Plugins in Aternos können mit speziellen Einstellungen konfiguriert werden, die es dem Benutzer ermöglichen, ihre Funktionalität und ihr Verhalten zu ändern. Das Hinzufügen von Einstellungen für ein Plugin kann nützlich sein, wenn Sie Benutzern die Möglichkeit geben möchten, das Plugin an ihre Bedürfnisse anzupassen.
Wenn Sie Einstellungen für ein Plugin hinzufügen, müssen Sie einige wichtige Punkte berücksichtigen:
- Legen Sie den Einstellungstyp fest: Textfeld, Optionsfeld, Auswahlliste usw.
- Legen Sie eine eindeutige ID für die Konfiguration fest, damit Sie über den Plugin-Code darauf zugreifen können.
- Legen Sie den Standardwert für die Einstellung fest, damit der Benutzer den Anfangswert sehen kann.
- Bearbeiten Sie die Anpassungswertänderungen, um die Änderungen im Plugin zu übernehmen.
Beispielcode zum Hinzufügen eines Textfelds als Plugin-Einstellung:
add_setting( 'my_plugin_settings', 'my_plugin_text', 'Текстовое поле', 'my_plugin_section' );
In diesem Beispiel fügen wir die Einstellung 'my_plugin_text' zum Abschnitt 'my_plugin_section' hinzu. Sie können dann den Wert der Einstellung mithilfe des folgenden Codes abrufen:
$my_plugin_text = get_setting( 'my_plugin_text' );
Mithilfe dieser Einstellungen können Sie das Verhalten des Plugins anpassen und dem Benutzer Flexibilität bei der Konfiguration seiner Funktionalität bieten.
Arbeiten mit Haken und Filtern
Hooks sind Punkte im Code, mit denen Sie sich mit Ihrem Code «verbinden» können. Sie sind Funktionen, die an bestimmten Stellen innerhalb eines Plugins oder Themas aufgerufen werden. Mit Hooks können Sie neue Funktionen hinzufügen oder vorhandene ändern. Um Hooks zu verwenden, müssen Sie ihre Namen und Orte kennen, an denen sie aufgerufen werden.
Filter sind wie Hooks, aber sie ermöglichen es Ihnen, die Daten zu ändern, die von einem Teil des Codes zum anderen übertragen werden, anstatt die Funktionalität selbst zu ändern. Filter funktionieren wie folgt: Sie übergeben die Daten an die Filterfunktion, und sie gibt die geänderten Daten zurück.
Um Hooks und Filter in Ihrem Plugin oder Thema zu verwenden, müssen Sie deren Namen kennen und welche Werte übertragen oder geändert werden können. Diese Informationen finden Sie in der Dokumentation oder im Quellcode des Plugins oder Themes.
Beispiel für die Verwendung von Hook:
function my_custom_function() < // ваш код >add_action('hook_name', 'my_custom_function');
Beispiel für die Verwendung eines Filters:
function my_custom_filter($value) < // ваш код return $value; >add_filter('filter_name', 'my_custom_filter');
Hooks und Filter sind unverzichtbare Werkzeuge für die Entwicklung von Plugins und Themes in Aternos. Sie bieten maximale Flexibilität und erleichtern die Wartung und Aktualisierung Ihres Codes. Verwenden Sie Hooks und Filter, um die Funktionalität Ihrer Website anzupassen und zu erweitern, ohne den Quellcode ändern zu müssen.
Testen und Veröffentlichen eines Plugins
Nachdem Sie ein Plugin für Aternos entwickelt haben, müssen Sie einen Test durchführen, um sicherzustellen, dass es funktioniert und fehlerfrei ist. Dazu können Sie einen lokalen Server verwenden oder die Funktionalität von Aternos nutzen, um das Plugin auf einen Testserver herunterzuladen.
Es ist wichtig, jede Funktion des Plugins auf eine ordnungsgemäße Funktion zu überprüfen und sicherzustellen, dass sie keine Konflikte mit anderen Plugins oder Serverfunktionen verursacht. Es wird empfohlen, alle möglichen Plug-in-Szenarien vollständig zu testen.
Wenn während des Testvorgangs Fehler oder Inkonsistenzen auftreten, müssen Sie diese korrigieren und das Plugin erneut testen, bevor es veröffentlicht wird.
Nachdem Sie alle gefundenen Fehler erfolgreich getestet und korrigiert haben, können Sie mit der Veröffentlichung des Plugins auf Aternos beginnen. Dazu müssen Sie eine Plugin-Beschreibung erstellen, die den Benutzern angezeigt wird, wenn Sie die zu installierenden Plugins auswählen.
Die Beschreibung des Plugins muss Informationen über den Namen, die Version, den Autor und die Hauptfunktionen des Plugins enthalten. Es wird auch empfohlen, die Versionsanforderungen für den Server und andere Plugins anzugeben.
Nachdem Sie eine Plugin-Beschreibung erstellt haben, müssen Sie sie auf der Aternos-Plattform veröffentlichen. Folgen Sie den Anweisungen auf der Website, um das Plugin hinzuzufügen und seine Dateien herunterzuladen.
Nachdem das Plugin erfolgreich veröffentlicht wurde, kann es auf den Aternos-Servern installiert und verwendet werden. Benutzer können ein Plugin aus der Liste der verfügbaren Plugins auswählen und es auf ihrem Server aktivieren.