EG Repo Card

Descrizione

EG Repo Card mostra una card compatta per un repository di codice ospitato su GitHub, Codeberg o qualsiasi istanza Forgejo o Gitea. Aggiungi lo shortcode con l’indirizzo del repository e la card mostra:

• nome del repository, logo della piattaforma e descrizione
• pulsanti per il sito web del progetto, il codice sorgente e il download dell’ultima versione
• data dell’ultimo aggiornamento (al passaggio del mouse compare il tempo trascorso)
• numero di versione, preso dall’ultima versione pubblicata oppure, se non ce ne sono, dall’ultimo tag git
• linguaggio principale, licenza e numero di stelle
• l’etichetta “Archiviato” per i repository in sola lettura

Lo stesso shortcode funziona con i plugin della directory di WordPress.org. La loro card mostra nome, icona e descrizione del plugin, la pagina del plugin, il download dell’ultima versione, la versione di WordPress fino a cui è testato, le installazioni attive e la valutazione media. I plugin chiusi hanno l’etichetta “Chiuso”.

La card si adatta al tuo tema: card e pulsanti possono usare un preset neutro, uno sfondo trasparente, un colore personalizzato oppure seguire la modalità chiara o scura del browser del visitatore. Testo e icone restano sempre leggibili sullo sfondo scelto.

Il plugin tiene in cache i dati dei repository. Se la piattaforma non risponde, la card continua a mostrare gli ultimi dati ricevuti: i visitatori non vedono mai un messaggio di errore.

Uso

Inserisci lo shortcode in qualsiasi articolo, pagina o widget:

[eg-repo-card url=”https://github.com/WordPress/wordpress-develop”]
[eg-repo-card url=”https://codeberg.org/forgejo/forgejo”]
[eg-repo-card url=”https://git.emanuelegori.uno/emanuelegori/eg-repo-card”]
[eg-repo-card url=”https://wordpress.org/plugins/akismet/”]

L’indirizzo è quello che vedi nel browser sulla pagina del repository o del plugin. Per Forgejo e Gitea va bene qualsiasi istanza, comprese quelle self-hosted.

Servizi esterni

Per costruire una card, il plugin chiede i dati pubblici alla piattaforma che ospita il repository o il plugin. Contatta solo gli host scritti negli shortcode del tuo sito, dal tuo server, e solo quando qualcuno visualizza una pagina con una card e i dati in cache sono scaduti. Non invia nessun dato sui tuoi visitatori.

GitHub

• Che cosa: l’API REST di GitHub (host api.github.com), per leggere i dati di un repository pubblico su GitHub.
• Quando: quando qualcuno visualizza una pagina con una card di GitHub e i dati in cache sono scaduti.
• Richieste: /repos/{owner}/{repo}, /repos/{owner}/{repo}/releases/latest e, se non ci sono versioni pubblicate, /repos/{owner}/{repo}/tags.
• Dati inviati: proprietario e nome del repository, più il token di accesso personale se ne hai salvato uno.
• Dati ricevuti: dati pubblici del repository (descrizione, sito web, stelle, linguaggio, licenza, ultima versione pubblicata e ultimo tag).
• Termini di servizio: https://docs.github.com/en/site-policy/github-terms/github-terms-of-service
• Privacy policy: https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement

Codeberg

• Che cosa: l’API di Codeberg (host codeberg.org, percorso /api/v1), per leggere i dati di un repository pubblico su Codeberg.
• Quando: quando qualcuno visualizza una pagina con una card di Codeberg e i dati in cache sono scaduti.
• Richieste: le stesse delle istanze Forgejo e Gitea, qui sotto.
• Dati inviati: proprietario e nome del repository, più il token Forgejo se ne hai salvato uno.
• Dati ricevuti: dati pubblici del repository (descrizione, sito web, stelle, linguaggio, licenza, ultima versione pubblicata e ultimo tag).
• Termini di utilizzo: https://codeberg.org/codeberg/org/src/branch/main/TermsOfUse.md
• Privacy policy: https://codeberg.org/codeberg/org/src/branch/main/PrivacyPolicy.md

Istanze Forgejo e Gitea

Forgejo e Gitea sono software libero che chiunque può ospitare: non esiste un servizio centrale. Il plugin contatta solo l’istanza che il proprietario del sito indica in uno shortcode (per esempio git.emanuelegori.uno in [eg-repo-card url="https://git.emanuelegori.uno/emanuelegori/eg-repo-card"]), tramite l’API dell’istanza stessa.

• Che cosa: l’API di quell’istanza, per leggere i dati di un repository pubblico ospitato lì.
• Quando: quando qualcuno visualizza una pagina con una card di quell’istanza e i dati in cache sono scaduti.
• Richieste: /api/v1/repos/{owner}/{repo}, /api/v1/repos/{owner}/{repo}/releases e, se non ci sono versioni pubblicate, /api/v1/repos/{owner}/{repo}/tags. Una volta alla settimana per istanza, /api/forgejo/v1/version, solo per distinguere Forgejo da Gitea e mostrare il logo giusto.
• Dati inviati: proprietario e nome del repository, più il token Forgejo o Gitea se ne hai salvato uno.
• Dati ricevuti: dati pubblici del repository (descrizione, sito web, stelle, linguaggio, licenza, ultima versione pubblicata e ultimo tag).
• Termini di servizio e privacy policy sono quelli dell’istanza scelta, pubblicati da chi la gestisce.

WordPress.org

• Che cosa: l’API della directory dei plugin di WordPress.org (host api.wordpress.org, percorso /plugins/info/1.2/), per leggere i dati di un plugin presente nella directory.
• Quando: quando qualcuno visualizza una pagina con la card di un plugin di WordPress.org e i dati in cache sono scaduti.
• Dati inviati: lo slug del plugin. Il plugin non usa nessun token.
• Dati ricevuti: dati pubblici del plugin (nome, descrizione, icona, versione, ultimo aggiornamento, versione di WordPress testata, installazioni attive, valutazione, link per il download).
• Privacy policy: https://wordpress.org/about/privacy/

Avatar del proprietario e icona del plugin

L’immagine è disattivata per impostazione predefinita. Se la abiliti, i browser dei visitatori caricano l’avatar del proprietario o l’icona del plugin direttamente dalla piattaforma che li ospita (GitHub, Codeberg, l’istanza Forgejo o Gitea, oppure WordPress.org), che riceve l’indirizzo IP del visitatore come per qualsiasi immagine.