Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/momentumlab-ch/mlab-git-connector/archive/refs/heads/main.zipUpdates itself. It ships its own updater, so new versions appear under Dashboard → Updates.
WordPress-Plugin, das Plugins und Themes direkt über eine GitHub-URL installiert. Updates laufen danach über den Standard-Updater von WordPress.
Status
Version 1.1.0. Installation, Update-Prüfung und Release-Workflow sind umgesetzt. Ein Test auf einer echten WordPress-Site steht noch aus.
Nutzung
- Plugin installieren und aktivieren.
- Im Backend Plugins → Aus GitHub installieren öffnen.
- Die GitHub-Adresse eines Repos eingeben, z. B.
https://github.com/momentumlab-ch/mlab-forms. - Das Plugin lädt das ZIP des neuesten Releases und installiert es. Die Aktivierung erfolgt danach auf der Plugin-Seite.
Das Repo braucht ein Release mit einer ZIP-Datei, die <slug>.zip heißt und den Ordner <slug>/ oben enthält. Der automatische GitHub-Quellcode wird nicht installiert.
Festgelegte Werte
| Bereich | Wert |
|---|---|
| Plugin-Slug (Ordner im ZIP) | mlab-git-connector |
| Funktions- und Klassen-Präfix | mlab_git_connector_ / Mlab_Git_Connector_ |
| Konstanten-Präfix | MLAB_GIT_CONNECTOR_ |
| Token-Konstante für private Repos | MLAB_GIT_CONNECTOR_GITHUB_TOKEN (in wp-config.php) |
| Text Domain | mlab-git-connector (Quelle Englisch, Sprachdatei de_CH in languages/) |
| Feste Werte (Timeouts u. a.) | inc/options.php, Filter mlab_git_connector_options |
| Update-Quelle | GitHub Releases dieses Repos, über Plugin Update Checker |
Entscheidungen
- Installation: Nur Hosts
github.comwerden akzeptiert. Installiert wird das Release-ZIP<slug>.zip, nie das automatische Quellcode-ZIP. - Updates: Plugin Update Checker v5, kein eigener Update-Code, keine Cronjobs. Geprüft wird alle 12 Stunden.
- Private Repos: Das Repo
mlab-git-connectorist öffentlich, deshalb braucht die Update-Prüfung keinen Token (private = falseininc/updater.php). Für ein privates Repo auftruesetzen und den Token inwp-config.phpeintragen. - Vorbild: Verhalten wie WP Pusher (Installation per GitHub-URL), aber auf Plugin Update Checker aufgebaut.
- Sicherheit: Nonce und
install_plugins-Recht bei jeder Aktion, alle Eingaben werden bereinigt, alle Ausgaben escaped.
Release
- Version in Header, Konstante
MLAB_GIT_CONNECTOR_VERSIONundStable taginreadme.txterhöhen. Eintrag inCHANGELOG.mdund im Changelog derreadme.txtergänzen. - Nach dem Merge auf
mainerkennt.github/workflows/release.ymldie neue Version, prüft Ordnername, Versionen und Secrets, bautmlab-git-connector.zipund legt das ReleasevX.Y.Zan. Es wird kein Tag von Hand gesetzt.
Prüfungen
- PHPCS mit den WordPress-Standards (
phpcs.xml.dist): ohne Befund. - PHP-Syntax aller Dateien: ohne Befund.