Aller au contenu principal
Version: 0.7.3

Gitlab

L'updater GitLab permet de gérer les mises à jour de vos thèmes et plugins directement depuis un dépôt GitLab.

Prérequis​

  • Un dépôt GitLab (auto-hébergé ou gitlab.com)
  • Pour les dépôts privés : un token d'accès avec les droits appropriés
  • Pour GitLab auto-hébergé : l'URL de votre instance

Configuration requise​

Pour les dépôts privés​

Créez un token d'accès avec les portées :

  • read_api : Pour accéder à l'API GitLab
  • read_repository : Pour accéder au dépôt

Utilisation​

Initialisation​

use Elementum\Updater\Gitlab;

$updater = new Gitlab(
    repo: 'utilisateur/nom-du-depot',  // Chemin du dépôt
    accessToken: 'votre_token',        // Optionnel pour les dépôts privés
    url: 'https://gitlab.example.com'  // Optionnel pour GitLab auto-hébergé
);

Paramètres​

ParamètreTypeRequisDescription
repostringOuiChemin du dépôt (ex: 'utilisateur/nom-du-depot')
accessTokenstringNonToken d'accès pour les dépôts privés
urlstringNonURL personnalisée pour GitLab auto-hébergé

Intégration avec les facades​

Pour un thème​

global $kernel;

$theme = $kernel->getTheme();
$theme->defineUpdater(new Gitlab(
    repo: 'votre-utilisateur/votre-theme',
    accessToken: 'votre_token'
));

Pour un plugin​

global $kernel;

$plugin = $kernel->getPlugin(__DIR__);
$plugin->defineUpdater(new Gitlab(
    repo: 'votre-utilisateur/votre-plugin',
    accessToken: 'votre_token'
));