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