Dit document is voor de beheerders van de piratenpartij website. Het document beschrijft hoe er nieuwe afdeling sites kunnen worden aangemaakt.

Dit aanmaken houd in dat er

• Een nieuwe site wordt gemaakt met een eigen subdomein
• Dat de basis structuur wordt aangemaakt in de nieuwe site

Verder is het handig om de handleiding 'Websites_Piratenpartij_Content.odt' er bij te hebben. Hierin worden de specifieke template en opmaak eigenschappen besproken, inclusief stappenplan voor het instellen.

De volgende aannames zijn er gedaan om dit werkend te krijgen

1. In de DNS staat er een wildcard record voor *.piratenpartij.nl. Voor zowel IPv4 als voor IPv6.
2. Dat er een wildcard SSL is geïnstalleerd. Alle sites zullen gebruik maken van *.piratenpartij.nl.
3. Dat er een email adres [afdeling]@piratenpartij.nl bestaat die wordt uitgelezen.

Om een nieuwe afdeling site te maken, moeten er een paar stappen worden doorlopen. Deze stappen worden hier uitgelegd.

1. Login op de hoofdwebsite https://piratenpartij.nl/wp-admin
2. Ga dan naar: 'Mijn sites' → 'Netwerkbeheer' → 'Sites'
3. Klik op de knop 'Nieuwe site toevegen'
4. Vul dan de volgende gegevens in, in het formulier
   1. Website adres: [afdeling].piratenpartij.nl
   2. Website titel: Piratenpartij [Afdeling]
   3. Beheerder e-mail adres: [afdeling]@piratenpartij.nl
5. Na het opslaan krijg je een bevestiging dat de site is aangemaakt.
6. Klik op de link 'Bezoek het Dashboard' om de site verder in te richten.
7. Als je op de Dashboard van de nieuwe afdeling site bent, ga naar: 'Extra' → 'Importeren'.
8. Kies nu voor de optie 'Wordpress'
9. Upload daar de WordPress eXtended RSS: 'piratenpartij_wordpress_nieuws_site_start.xml ' (moet nog gemaakt worden).Selecteer de xml file en klik op 'Bestand uploaden en importeren'
10. In het nieuwe scherm moet je dan de content eigenaar goed zetten. Dit doe je door de bestaande gebruiker in de import file aan de nieuwe beheerder te koppelen.Check ook het vinkje aan bij 'Download en importeer bijlagen'. Klik op verstuur om de data te importeren.
11. Als laatste krijg je de melding dat de data goed is geïmporteerd

Als er een nieuwe site is aangemaakt, moet deze nog verder worden ingericht. Dit inrichten gaat via een import file. Dit scheelt werk en typefouten.
Voor alle acties geldt dat je ingelogd op de afdeling site moet zijn

1. Geordende lijstLogin op de website van de afdeling: https://[afdeling].piratenpartij.nl/wp-admin, of als je net de site hebt aangemaakt, klik op de link 'Bezoek het Dashboard'

De volgende zaken moeten worden ingesteld. Dit lijkt een lange lijst, maar zal in praktijk niet meer dan 30 minuten kosten.

1. Website template
2. Website titel en ondertitel
3. Website menu
4. Widgets header
   1. Zoeken
   2. Social media links
5. Widgets rechts
   1. Wij zijn
   2. Kalender
   3. Piratennieuws
   4. Nieuws archief
   5. Categorieën
   6. Aanmelden
6. Agenda kleuren
7. Overbodige pagina's en reacties verwijderen

1. Ga naar thema pagina: 'Weergave' → 'Thema's'
2. Klik op de knop 'activeren' van de Piratenpartij Thema
3. De Piratenpartij template is nu actief, en tevens ook nog maar de enige template die beschikbaar is. Dit heeft als voordeel dat de afdeling eigenaar dit niet meer kan aanpassen.
4. De template is nu goed ingesteld.

1. Klik op Instellingen in het linke zwarte menu
2. Vul in het veld 'Websitetitel' de gewenste nieuws naam in. Piratenpartij [afdeling]
3. Vul in het veld 'Ondertitel' in: voor een vrije informatiesamenleving
4. Zorg dat het email adres klopt: [afdeling]@piratenpartij.nl
5. Controleer de tijdzone
6. Sla de nieuwe naam op door op de knop 'Wijzigingen opslaan'

1. Ga naar 'Weergave' → 'Menu's'
2. Je krijgt nu het hoofdmenu te zien voor de site. Dit hoofdmenu moet alleen nog worden toegekend in het CMS. Dit doe je door naar de optie 'Locatie beheren' te gaan.Daar kies je dan het menu 'Hoofdmenu' als Primary Menu. Sla dit op door op de knop 'Wijzigingen opslaan' te klikken.
3. Menu is nu ingesteld

Er zijn meerdere widgets nodig die ingesteld moeten worden. Voor de eerste keer, zorg er altijd dat je dan met een lege lijst begint.

1. Ga naar 'Weergave' → 'Widgets'
2. Zorg ervoor dat de initiële widgets uit de widgets gebieden 'Header' en 'Side bar right' zijn gehaald. Zo dat je met een lege lijst start

1. Klik op de widget 'Zoeken' en plaats deze in de Widget Header gebied.
2. Klik op de knop 'Widget toevoegen' en het zoek veld is ingesteld.

1. Klik op de widget 'Social Media Feather: Follow US' en plaats deze in de Widget Header gebied.
2. Klik op de knop 'Widget toevoegen' en het social media widget is ingesteld.
3. Vul de titel in met 'Volg ons' en stel de iconen op de maat 24×24 pixels in. En klik op de knop 'Opslaan'.
4. Voor het verder instellen van de juiste Social media links, kijk in de handleiding 'Basis handleiding piratenpartij website' bij het onderdeel 'Social Media icons'

1. Klik op de widget 'Wij zijn …' en plaats deze in de Widget Side bar right gebied.
2. Laat het tekst veld leeg voor de standaard Piratenpartij programma punten.
3. Een afdeling kan zelf hier de eigen programma punten invoeren om zo landelijk te overrulen.

1. Klik op de widget 'Aankomende activiteiten' en plaats deze in de Widget Side bar right gebied.
2. Vul de titel in met 'Kalender' en zit het 'Aantal weer te geven activiteiten' op 5. En klik op de knop 'Opslaan'.

1. Klik op de widget 'Really Simple Twitter' en plaats deze in de Widget Side bar right gebied.
2. In het vervolg scherm wordt er om API tokens voor twitter gevraagd. Laat deze leeg. Het is aan de beheerder om deze tokens in te voeren. Dit is afhankelijke van het gebruikte twitter account.
3. Voor het verder instellen van de juiste Twitter settings, kijk in de handleiding 'Basis handleiding piratenpartij website' bij het onderdeel 'Twitter feed'

1. Klik op de widget 'RSS' en plaats deze in de Widget Side bar right gebied.
2. Vul na het toevoegen van de Widget de volgende velden in:
   1. RSS Feed url: https://piratenpartij.nl/wp-content/themes/ppnl/pirate-news.php
   2. RSS Feed titel: Piratennieuws
3. Klik op de knop 'Opslaan' om de RSS feed widget op te slaan.

1. Klik op de widget 'Archief' en plaats deze in de Widget Side bar right gebied.
2. Vink de opties 'Als dropdown weergeven' en 'Berichtenaantal tonen' aan.
3. Klik op de knop 'Opslaan' om de archief widget op te slaan.

1. Klik op de widget 'Categorieën' en plaats deze in de Widget Side bar right gebied.
2. Vink de opties 'Als dropdown weergeven' en 'Berichtenaantal tonen' aan.
3. Klik op de knop 'Opslaan' om de categorieën widget op te slaan.

1. Klik op de widget 'Login With Ajax' en plaats deze in de Widget Side bar right
2. Vul de volgende waarden in
   1. Title (Logged in): Aanmelden
   2. Title (Logged out): Hoi %uesrname%
   3. Zet het vinkje achter 'AJAX registration' uit.
3. Klik op de knop 'Opslaan' om de aanmelden widget op te slaan.

Deze widget is alleen beschikbaar voor de landelijke pagina. Afdeling sites zullen deze widget niet hebben.

1. Klik op de widget 'Newsletter' en plaats deze in de Widget Side bar right
2. Vul de volgende gegevens in:
   1. Title: Nieuwsbrief
   2. Introduction: Nieuwsbrief ontvangen? Voer je e-mail adres hier in:
3. Klik op de knop 'Opslaan' om de aanmelden widget op te slaan.

Als alle widgets zijn ingesteld, zal dit de uiteindelijke overzicht zijn van de widgets pagina. Let goed op de volgorde van widgets. Als deze niet overeen komt met het onderstaande plaat, sleep de widgets in de juiste volgorde.

De agenda heeft verschillende instellingen nodig voordat deze goed werkt.

1. Ga naar 'Activiteiten' → 'Instellingen'
2. Stel daar de volgende onderdelen in
   1. Agenda pagina: Kalender
   2. De week start op: maandag
   3. Beschikbare weergaven: Zet de standaard op Maand
   4. Timezone: Amsterdam
3. Ga naar de sectie 'Toevoegen/Bewerken activiteiten' en stel daar de volgende instellingen in
   1. Gebruik 24 uurs
   2. Gebruik de ingestelde regio (WordPress locale) om te bepalen hoe de automatische aanvulling van adressen zich gedraagt
4. Sla de instellgen op door op de knop 'Bewaar instellingen' te klikken

Er moeten een aantal plugins goed worden ingesteld.

Hier is geen uitleg voor. Dit instellen zou voor een beheerder geen probleem moeten zijn. (Of moet nog worden aangevuld met extra informatie)

Dit zal geinstalleerd moeten worden volgens de algemene plugin installatie

Na het opzetten van de nieuwe site, is er atlijd 1 bericht en 1 reactie.

1. Ga naar 'Berichten' → 'Alle berichten'
2. Ga met de muis over het bericht heen, en klik op de rode 'Prullenbak' optie. Let op, er komt geen bevestiging!
3. Nu is het demo bericht verwijderd. Hiermee wordt ook de demo reactie die bij dit bericht zit verwijderd. Eventueel kun je nu ook nog de prullenbak legen.
4. Ga nu naar 'Pagina' → 'Alle berichten'
5. Scroll naar beneden naar de pagina 'Voorbeeld pagina'. Ga met de muis over de pagina heen, en klik op de rode 'Prullenbak' optie. Let op, er komt geen bevestiging!
6. Hiermee is de demo pagina verwijderd. Eventueel kun je nu ook nog de prullenbak legen.

En nu is de site klaar!
Stuur de beheerder een email met uitleg, en het document 'Websites_Piratenpartij_Content.odt' voor uitleg over de werking van de site

Het is ook mogelijk om een subdomein naam aan te maken voor een afdeling, zonder dat deze een eigen website hebben. Sommige afdelingen zijn minder actief, en hebben genoeg aan 1 pagina op de landelijke site. Dit is nu bijvoorbeeld voor Zwolle.

Als je naar https://zwolle.piratenpartij.nl gaat, kom je uit op https://piratenpartij.nl/regionaal/zwolle/

Om dit mogelijk te maken moet er ingelogd worden op de webserver (ssh), en de volgende nginx configuratie worden aangepast. Per regel staat de volledige hostname zonder protocol gevolgd met een spatie en dan de pagina url zonder host of tussen paden.

/etc/nginx/piratenpartij.afdeling.redirects.conf

## Zet hier de subdomein neer, met daarachter de afdeling pagina naam
## Voorbeeld: https://zwolle.piratenpartij.nl → https://piratenpartij.nl/regionaal/zwolle/

map $host $afdeling_redirect {
  default 0;
  hoekschewaard.piratenpartij.nl hoekschewaard;
  zwolle.piratenpartij.nl zwolle;
}

Als de nieuwe afdeling er in staat, moet NGINX herladen worden, en zal de redirect werken.
Deze redirects kunnen dus niet vanuit Wordpress (CMS) ingesteld worden. Daarom is dit alleen mogelijk door systeembeheerders. En er kunnen alleen afdeling sites worden geredirect.