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'
));