# maca DownList — Användarguide (referens)

Den fullständiga guiden i wp-admin finns per språk under **maca DownList → Guide** (`admin/guides/`). Denna fil är en kort referens på svenska.

**maca DownList** · utvecklare **maca development** · [https://maca.se](https://maca.se)

maca DownList är ett WordPress-tillägg för att visa nedladdningsbara filer med tumnagel, rubrik, beskrivning och knappar.

## Installation

1. Kör `.\pack-plugin.ps1` i projektroten (skapar `maca-downlist-{version}.zip`) eller packa mappen manuellt.
2. Gå till **Tillägg → Lägg till** i WordPress och ladda upp zip-filen, eller kopiera mappen till `wp-content/plugins/maca-downlist/`.
3. Aktivera **maca DownList**.

## Skapa listor och filer

1. **maca DownList → Lists** — skapa t.ex. `Broschyrer` (slug blir oftast `broschyrer`).
2. **maca DownList → Add New** — lägg till en fil:
   - **Titel** = rubrik på kortet
   - **Editor** = förklarande text
   - **File Details** = tumnagel, nedladdningsfil, valfri info-URL, sorteringsordning
   - **Lists** = välj vilken lista filen ska ingå i
3. Publicera filen.

## Visa på webbplatsen

### Shortcode

```
[maca_downlist list="broschyrer" layout="grid" limit="-1"]
```

Utan `list` (eller med `list="all"`): alla listor visas grupperade.

| Parameter | Beskrivning |
|-----------|-------------|
| `list` | Valfritt. Listans slug eller ID; utelämna / `all` = alla listor. |
| `layout` | `grid` (standard) eller `list`. |
| `limit` | Max antal filer, `-1` = alla. |

### Block

Sök efter **maca DownList List** i blockredigeraren, välj lista (eller alla), layout och max antal filer (limit) i sidopanelen.

## Hämtningsstatistik

Kolumnen **Hämtningar** visas i admin under Filer och Listor (spårade nedladdningar via pluginets länkar).

## PDF

**Visa** öppnar PDF i webbläsaren; **Ladda ner** sparar filen.

## Integritet

Vid aktivering, inaktivering och avinstallation kan tillägget skicka en liten livscykelhändelse till api.maca.se (webbplats-URL, versioner, språk). Valfri feedback vid inaktivering skickas samma väg. Nedladdningsfiler och besökares trafik stannar på webbplatsen. Inga licenskontroller i WordPress.org-bygget.

## Språk

- **Standard:** engelska (används om webbplatsens språk inte finns nedan)
- **Översättningar:** svenska, danska, norska (bokmål), finska, tyska, franska, spanska

Sätt språk under **Inställningar → Allmänt** i WordPress. Tillägget laddar automatiskt rätt `.mo`-fil från mappen `languages/`.

| WordPress-språk | Fil |
|-----------------|-----|
| Svenska | `maca-downlist-sv_SE.mo` |
| Dansk | `maca-downlist-da_DK.mo` |
| Norsk bokmål | `maca-downlist-nb_NO.mo` |
| Finska | `maca-downlist-fi_FI.mo` |
| Tyska | `maca-downlist-de_DE.mo` |
| Franska | `maca-downlist-fr_FR.mo` |
| Spanska | `maca-downlist-es_ES.mo` |

## Uppdateringar

- **WordPress.org:** uppdateringar sker automatiskt när tillägget finns i katalogen (se `docs/WORDPRESS-ORG.md`).

## WordPress.org

Se [docs/WORDPRESS-ORG.md](docs/WORDPRESS-ORG.md) för publicering och SVN-uppdateringar.

## Filstruktur

```
maca-downlist/
  maca-downlist.php
  includes/
  admin/
  public/
  templates/
  languages/
  blocks/
```
