Ansico-plugins/ansico-plugins/README.md

Ansico Plugins

Version: 0.0.0.1
Forfatter: Andreas Andersen (Ansico)
URL: https://ansico.dk

Formål

Dette plugin gør det muligt at forbinde et WordPress-site til en Forgejo-server og bruge udvalgte repositories som et privat plugin-katalog.

Hvad kan pluginet i denne version?

• Gemme forbindelsesoplysninger til Forgejo
• Teste forbindelsen til Forgejo
• Hente repositories fra en bruger eller organisation
• Filtrere repositories på topic
• Vise seneste release for hvert repository
• Finde første ZIP-asset i seneste release
• Installere pluginet direkte fra den ZIP-fil

Sådan opsætter du det

1. Installer og aktivér pluginet i WordPress.
2. Gå til Indstillinger → Ansico Plugins.
3. Udfyld:
   • Forgejo base URL – fx https://forgejo.example.com/
   • Bruger eller organisation – den konto der ejer repos
   • Owner-type – Bruger eller Organisation
   • Access token – nødvendigt for private repos
   • Topic-filter – fx wordpress-plugin
4. Gem indstillinger.
5. Klik på Test forbindelse.
6. Gå til Plugins → Ansico Plugins.
7. Klik på Installér / opdatér ud for det ønskede plugin.

Krav til releases på Forgejo

Hver plugin-release bør have en ZIP-asset som:

• ender på .zip
• indeholder plugin-mappen i roden
• indeholder en gyldig WordPress-pluginfil

Eksempel:

mit-plugin.zip

• mit-plugin/
• mit-plugin/mit-plugin.php
• mit-plugin/includes/...

Begrænsninger i version 0.0.0.1

• Pluginet bruger første ZIP-fil i seneste release
• Ingen automatisk versionssammenligning i WordPress’ normale update-UI endnu
• Ingen changelog-modal endnu
• Ingen cachelagring af API-kald endnu

Næste oplagte trin

• Integrere med WordPress’ normale plugin-opdateringer
• Understøtte manifest-fil pr. repo
• Understøtte changelog og plugin-detaljer
• Tilføje caching og bedre fejlvisning