LucaFox Affiliate Links

Plugin WordPress per gestire link affiliati stabili del tipo /go/slug, pensato per descrizioni YouTube, pagine kit e prodotti consigliati.

Stato del progetto

Versione: 0.2.5

La parte redirect è funzionante. La parte Amazon Creators API è integrata ma dipende dall'effettiva abilitazione dell'account Amazon Associates. Se Amazon restituisce AssociateNotEligible, il plugin sta autenticando la richiesta ma l'account non è ancora abilitato o non soddisfa i requisiti API.

Funzioni principali

• Redirect pubblici tipo https://tuodominio.it/go/hackrf.
• Redirect 302, 307, 301 o 308.
• URL di fallback se il prodotto è segnato come non disponibile.
• Conteggio click.
• Gestione ASIN e marketplace.
• Badge stato disponibilità:
  • verde: disponibile;
  • rosso: non disponibile / errore API;
  • arancione: unknown / stato non determinato.
• Pagina principale con lista link esistenti.
• Pagina separata “Nuovo link”.
• Impostazioni Amazon.
• Controllo manuale disponibilità.
• Cron giornaliero.
• Log dei controlli.
• Notifiche email su cambio stato.
• Provider modulari:
  • Amazon Creators API;
  • PA-API legacy, solo per compatibilità.

Installazione da WordPress

1. Scarica lo ZIP del plugin dalla sezione release.
2. Vai in WordPress: Plugin → Aggiungi plugin → Carica plugin.
3. Carica lo ZIP.
4. Attiva LucaFox Affiliate Links.
5. Vai in Affiliate Links → Impostazioni Amazon.
6. Configura provider, marketplace, tag affiliato ed eventuali credenziali.
7. Crea un link da Affiliate Links → Nuovo link.

Installazione manuale

Copia la cartella del plugin in:

wp-content/plugins/lucafox-affiliate-links/

poi attivalo dal pannello WordPress.

Configurazione Creators API

Campi tipici:

Provider API: Creators API
Associate Tag: il tuo tag Amazon Associates, es. nomesito-21
Marketplace predefinito: www.amazon.it
Endpoint catalogo Creators API: lascia vuoto per usare il default
Token endpoint OAuth: lascia vuoto per usare il default
Credential Version: 3.2 per Italia/Europa
Application ID: valore mostrato nel pannello Amazon, usato come riferimento
Credential ID: valore mostrato nel pannello Amazon
Credential Secret: valore mostrato nel pannello Amazon

Endpoint catalogo default:

https://creatorsapi.amazon/catalog/v1/getItems

Per l'Italia/Europa la credential version normalmente è:

3.2

Se Amazon restituisce:

AssociateNotEligible

significa che le credenziali sono arrivate fino ad Amazon, ma l'account non è ancora eleggibile o non è ancora propagato/abilitato.

Uso consigliato

Nei video YouTube usare sempre link propri:

https://donluca.it/go/hackrf
https://donluca.it/go/rtlsdr
https://donluca.it/go/meshtastic

Nel plugin questi link possono puntare a:

• Amazon con link affiliato;
• Geniuslink;
• pagina kit del sito;
• pagina fallback con alternative.

Disclosure affiliazioni

Nelle descrizioni YouTube o nelle pagine pubbliche usare una formula chiara, per esempio:

Alcuni link sono affiliati: se acquisti tramite questi link posso ricevere una piccola commissione, senza costi aggiuntivi per te.

Sicurezza

Non committare mai credenziali reali nel repository.

Le credenziali inserite nel plugin vengono salvate nelle opzioni WordPress e sono visibili agli amministratori del sito. Per un uso personale con unico amministratore può essere sufficiente; per ambienti multi-admin o più critici valutare una gestione tramite costanti in wp-config.php o secret manager.

Sviluppo locale

Clona il repository in una installazione WordPress locale:

git clone https://github.com/USERNAME/lucafox-affiliate-links.git wp-content/plugins/lucafox-affiliate-links

Poi attiva il plugin da WordPress.

Creare uno ZIP installabile

Da root repository:

cd ..
zip -r lucafox-affiliate-links.zip lucafox-affiliate-links \
  -x "*.git*" \
  -x "*/.github/*" \
  -x "*/.DS_Store" \
  -x "*/node_modules/*"

Changelog

0.2.5

• Fix Creators API: token OAuth2 v3.x tramite body JSON.
• Marketplace incluso anche nel body della chiamata getItems.
• Cache token separata per credential/versione.
• Diagnostica migliorata sugli errori HTTP Amazon.

0.2.4

• Parser Creators API più robusto per risposte incapsulate in Output / Version.
• Diagnostica migliorata per availability non ricavabile.

0.2.3

• Pagina principale con sola lista link esistenti.
• Nuova pagina sidebar: “Nuovo link”.
• Badge colorati per disponibilità.
• Parser Creators API più tollerante sulle varianti del campo availability.

0.2.1

• Aggiunto il campo Creators API Application ID separato dal Credential ID.

Licenza

GPLv2 or later.