L'estensione Git Download Updater supporta sia GitHub che BitBucket.
Connessione a BitBucket
Per connettere il tuo sito Easy Digital Downloads al tuo account Bitbucket, dovrai creare un'APP all'interno del tuo account Bitbucket e quindi aggiungere la Password dell'APP e il tuo nome utente Bitbucket nelle impostazioni dell'estensione.
Per creare una password dell'app segui i passaggi qui sotto:
- Dall'icona a forma di ingranaggio in alto a destra, seleziona Impostazioni personali Bitbucket.
- Seleziona Password dell'app sotto Gestione dell'accesso.
- Seleziona Crea password dell'app.
- Dai un nome alla password dell'app che ti aiuti a ricordare per cosa viene utilizzata.
- Nella sezione Autorizzazioni seleziona le caselle per:
- Copia la password generata in un luogo sicuro per ora. La password viene visualizzata solo una volta.
Ecco un'immagine di tutte le autorizzazioni richieste descritte al passaggio 5 sopra:
Maggiori dettagli sulle password delle app (incluso l'uso e la revoca) sono disponibili nella documentazione di Bitbucket.
Una volta ottenuta la nuova password dell'app, aggiungila alla pagina Download > Impostazioni > Estensioni > Git Updater.
Il campo Nome utente è il tuo vero nome utente Bitbucket (non confonderlo con l'email dell'account). Puoi trovarlo facilmente in questa pagina: https://bitbucket.org/account/settings/ nella sezione “Impostazioni del profilo Bitbucket”.
Connessione a GitHub
Per utilizzare GitHub, naviga su Download > Impostazioni > Estensioni > Git Updater. Segui le istruzioni lì per connetterti a GitHub.
Configurazione di un Download con Git Updater
Impostazione dei file di download
Una volta connesso il tuo sito a GitHub o Bitbucket, puoi aggiungere file ai tuoi prodotti di Download.
1. Il metarbox “File di download” nella schermata di modifica del download avrà ora una casella di controllo etichettata “Recupera download da un repository git”.
2. Dopo un momento, apparirà una nuova serie di campi che ti permetteranno di selezionare un repository.
3. Cerca il nome del repository, quindi seleziona il tag che desideri utilizzare.
Nota: Il Tag di versione utilizzato in Git Updater deve essere un tag git nativo. Non analizza le versioni dal tuo file readme. Per saperne di più sull'uso della funzionalità di tag in git, puoi visitare questa guida.
4. Fai clic su “Recupera ora”. Quando il tuo download è stato importato con successo dal repository git, il pulsante dirà “Recuperato”.
5. Ora puoi modificare il nome del file e/o dello zip, se lo desideri, o lasciarli come predefiniti. Il tuo file zip è pronto!
Quando sei pronto per rilasciare una nuova versione, seleziona semplicemente il tag che desideri utilizzare e fai clic su recupera. Dopo che il recupero è completo, aggiorna il tuo prodotto.
FAQ e risoluzione dei problemi
Come escludo o rimuovo file prima che venga generato lo zip?
Il Git Download Updater utilizza la funzionalità di 'export' di Git per creare il file da distribuire. Puoi usare il file `.gitattributes` per determinare quali file ignorare durante l'esportazione. Ecco un esempio di come lo usiamo per EDD Core.
Per maggiori dettagli sull'uso degli attributi git per escludere file, vedi questo tutorial.
Conflitto di aggiornamento tra versione gratuita e a pagamento
Ci sono due modi diversi per risolvere questo problema:
- Cambia il nome e/o lo slug della versione pro. A causa di una sfumatura nell'API di aggiornamento di WordPress, WordPress non può distinguerli come plugin separati.
- Aggiungi "wp_override" al terzo parametro della classe EDD_SL_PLugin_Updater quando viene istanziata, in questo modo:
// set up the updater
$edd_updater = new EDD_SL_Plugin_Updater( EDD_SAMPLE_STORE_URL, __FILE__, array(
'version' => '1.0', // current version number
'license' => $license_key, // license key (used get_option above to retrieve from DB)
'item_id' => EDD_SAMPLE_ITEM_ID, // name of this plugin
'author' => 'Easy Digital Downloads', // author of this plugin,
'wp_override' => true
)
);Nota: questo richiede la v1.6.4 della classe di aggiornamento del plugin.
