62 lines
1.9 KiB
Markdown
62 lines
1.9 KiB
Markdown
# 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
|