# Publicera maca DownList på WordPress.org

## Rätt projektmapp (inte SmartFiles)

All utveckling och scripts ska köras från:

```
C:\Users\maca5\appar\WP-Plugin\maca-downlist\
```

SVN-arbetskopia (skapas av script):

```
C:\Users\maca5\appar\WP-Plugin\maca-downlist-svn\
```

Öppna **maca-downlist** som Cursor/VS Code-projekt — inte `SmartFiles\SmartFiles`.

## Förkrav

1. Konto på [WordPress.org](https://wordpress.org/support/register.php)
2. Tillägget följer [Plugin Guidelines](https://developer.wordpress.org/plugins/wordpress-org/detailed-plugin-guidelines/)
3. GPL-licens (redan i `maca-downlist.php`)
4. `readme.txt` enligt [readme standard](https://developer.wordpress.org/plugins/wordpress-org/how-your-readme-txt-works/)

## Förberedelse

1. Verifiera att textdomain `maca-downlist` används överallt med `__()`, `_e()`, etc.
2. Generera/uppdatera `.pot` i `languages/` (med WP-CLI: `wp i18n make-pot . languages/maca-downlist.pot`).
3. Kompilera svenska: `msgfmt -o languages/maca-downlist-sv_SE.mo languages/maca-downlist-sv_SE.po`
4. Skapa zip med mappnamn `maca-downlist` (mappen som innehåller `maca-downlist.php`):

```powershell
# Från plugin-mappen maca-downlist/ (Windows)
.\pack-plugin.ps1
```

Skapar `maca-downlist.zip` i samma mapp. Exkluderar bland annat:

* `license-server/` (endast maca.se)
* `docs/`, `assets/` (SVN/marknadsföring, inte plugin-kod)
* `GUIDE.md`, `compile-languages.ps1`, `pack-plugin.ps1`
* `languages/compile-mo.py`, `build-pos.ps1`, `translations.csv`, `languages/README.md`

## Ansökan

1. Gå till [Add your plugin](https://wordpress.org/plugins/developers/add/)
2. Ladda upp zip och vänta på granskning
3. Efter godkännande får du SVN-åtkomst: `https://plugins.svn.wordpress.org/maca-downlist/`

## SVN-struktur

```
assets/          screenshot-1.png … screenshot-5.png, banner, icon (se nedan)
trunk/           all plugin-kod
tags/1.0.0/      kopia av trunk för varje release
```

### Screenshots (plugin-sidan på wordpress.org)

* I `readme.txt` under `== Screenshots ==` står bara **textrader** (bildtexter) — inga bildfiler i zip/trunk.
* Själva bilderna laddas upp i SVN-mappen **`assets/`** (sibling till `trunk/`, inte inuti plugin-mappen):
  * `screenshot-1.png` … `screenshot-5.png` (nummer = ordningen i readme)
  * PNG eller JPG, typiskt 1200 px bred (WordPress skalar om)
* Valfritt men rekommenderat: `banner-772x250.png`, `icon-256x256.png`, `icon-128x128.png`

## Publicera version (första gången)

1. Installera **Subversion** (t.ex. [TortoiseSVN](https://tortoisesvn.net/) — kryssa i “command line client”).
2. Från plugin-mappen:

```powershell
cd C:\Users\maca5\appar\WP-Plugin\maca-downlist
.\publish-org-svn.ps1 -Checkout
```

Skriptet: packar pluginet → fyller `trunk/` → kopierar `assets/` med rätt filnamn → skapar `tags/1.6.4/`.

3. Granska och commit:

```powershell
cd ..\maca-downlist-svn
svn status
svn ci -m "Release 1.6.4"
```

WordPress.org-konto + lösenord (eller sparat cert) krävs vid checkout/commit.

**Stable tag:** i `readme.txt` ska matcha tag-mappen (nu **1.6.4**).

Plugin-sida: https://wordpress.org/plugins/maca-downlist/

## Senare uppdateringar

1. Öka version i `maca-downlist.php` (header **och** `MACA_DOWNLIST_VERSION`)
2. Uppdatera `readme.txt`: **Stable tag** och ny `= x.y.z =` överst i changelog
3. Uppdatera `Project-Id-Version` i `languages/maca-downlist-*.po` (valfritt men bra)
4. Kör `.\pack-plugin.ps1` — avbryter om versionerna inte matchar
5. Kopiera till `trunk/`, commit, kopiera trunk till `tags/x.y.z/`, commit

## Premium + WordPress.org

- Gratisversion på .org, Pro som licens på maca.se
- **Licensserver:** eget repo `../maca-licensserver/` (se `docs/LICENSE-SERVER.md`)
- `includes/class-maca-downlist-updater.php` ingår **inte** i .org-zip (`pack-plugin.ps1`)
- `maca_downlist_update_remote` är för distribution **utanför** .org
