README

Hur man använder Region Hallands plugin "RhAcfPageKulturProgram"

Nedan följer instruktioner hur du kan använda pluginet "RhAcfPageKulturProgram".

Användningsområde

Denna plugin ger möjlighet att skapa poster med kulturhändelser

OBS! Enskilda poster visas på sidan "single-kulturprogram.blade.php" OBS! Listan med poster visas på sidan "archive-kulturprogram.blade.php"

Båda dessa filer finns med i foldern "views"

Licensmodell

Denna plugin använder licensmodell GPL-3.0. Du kan läsa mer om denna licensmodell via den medföljande filen:

LICENSE (https://regionhalland.visualstudio.com/public.RhWpPlugIns/_git/RhAcfPageKulturProgram?path=%2FLICENSE&version=GBmaster)

Installation och aktivering

A) Hämta pluginen via Git eller läs in det med Composer
B) Installera Region Hallands plugin i Wordpress plugin folder
C) Aktivera pluginet inifrån Wordpress admin

Hämta hem pluginet via Git

git clone https://regionhalland.visualstudio.com/public.RhWpPlugIns/_git/RhAcfPageKulturProgram

Läs in pluginen via composer

Dessa två delar behöver du lägga in i din composer-fil

Repositories = var pluginen är lagrad, i detta fall på github

"repositories": [
  {
    "type": "vcs",
    "url": "https://regionhalland.visualstudio.com/public.RhWpPlugIns/_git/RhAcfPageKulturProgram"
  },
],

Require = anger vilken version av pluginen du vill använda, i detta fall version 1.0.0

OBS! Justera så att du hämtar aktuell version.

"require": {
  "regionhalland/region-halland-acf-page-kulturprogram": "1.0.0"
},

Visa allt innehåll via "Blade" på en sida

<ol>
  <li>
      Typ:
      @php($arrLabels = get_region_halland_acf_page_kulturprogram_type_labels())  
      @if(isset($arrLabels))
        @foreach ($arrLabels as $label)
          {{ $label['label'] }}, 
        @endforeach
      @endif
  </li>
  <li>Målgrupp: {{ get_region_halland_acf_page_kulturprogram_malgrupp() }}</li>
  <li>Publik: {{ get_region_halland_acf_page_kulturprogram_publik() }}</li>
  <li>Längd: {{ get_region_halland_acf_page_kulturprogram_langd() }}</li>
  <li>Lokal: {{ get_region_halland_acf_page_kulturprogram_lokal() }}</li>
  <li>Turnéperiod: {{ get_region_halland_acf_page_kulturprogram_turne_period() }}</li>
  <li>Pris: {{ get_region_halland_acf_page_kulturprogram_pris() }}</li>
</ol>

Lista allt innehåll via "Blade" på en sida

OBS! Som default listas alla, men du kan ange valfritt antal när du anropar funktionen.

@php($myItems = get_region_halland_acf_page_kulturprogram_items())
@foreach($myItems as $item)
  <h2>{{ $item->post_title }}</h2><br>
  <span>{{ $item->post_content }}</span><br><br>
  <span>
    <strong>Typ:</strong>
    @foreach($item->labels as $label)
      {{ $label['label'] }}
    @endforeach
  </span><br>
  <span><strong>Målgrupp:</strong> {{ $item->malgrupp }}</span><br>
  <span><strong>Publik:</strong> {{ $item->publik }}</span><br>
  <span><strong>Speltid:</strong> {{ $item->speltid }}</span><br>
  <span><strong>Lokal:</strong> {{ $item->lokal }}</span><br>
  <span><strong>Period:</strong> {{ $item->period }}</span><br>
  <span><strong>Pris:</strong> {{ $item->pris }}</span><br><br><br>
@endforeach

Exempel på array

array (size=3)
  0 => 
    object(WP_Post)[6655]
      public 'ID' => int 736
      public 'post_author' => string '11' (length=2)
      public 'post_date' => string '2019-02-15 14:03:26' (length=19)
      public 'post_date_gmt' => string '2019-02-15 14:03:26' (length=19)
      public 'post_content' => string 'En dansclownföreställning för barn i åldern 6-10 år' (length=51)
      public 'post_title' => string 'Extrem(is)t Kul - En dansclownföreställning' (length=45)
      public 'post_excerpt' => string '' (length=0)
      public 'post_status' => string 'publish' (length=7)
      public 'comment_status' => string 'closed' (length=6)
      public 'ping_status' => string 'closed' (length=6)
      public 'post_password' => string '' (length=0)
      public 'post_name' => string 'extremist-kul-en-clowndansforestallning' (length=39)
      public 'to_ping' => string '' (length=0)
      public 'pinged' => string '' (length=0)
      public 'post_modified' => string '2019-03-13 13:43:36' (length=19)
      public 'post_modified_gmt' => string '2019-03-13 13:43:36' (length=19)
      public 'post_content_filtered' => string '' (length=0)
      public 'post_parent' => int 0
      public 'guid' => string 'http://exempel.se/?post_type=kulturprogram&#038;p=736' (length=53)
      public 'menu_order' => int 0
      public 'post_type' => string 'kulturprogram' (length=13)
      public 'post_mime_type' => string '' (length=0)
      public 'comment_count' => string '0' (length=1)
      public 'filter' => string 'raw' (length=3)
      public 'url' => string 'http://exempel.se/kulturprogram/extremist-kul-en-clowndansforestallning/' (length=72)
      public 'image' => string '' (length=0)
      public 'image_url' => boolean false
      public 'date' => string '2019-02-15' (length=10)
      public 'labels' => 
        array (size=2)
          0 => 
            array (size=1)
              'label' => string 'Dans' (length=4)
          1 => 
            array (size=1)
              'label' => string 'Film' (length=4)
      public 'malgrupp' => string '6–10 år' (length=10)
      public 'publik' => string '70 pers inkl. personal' (length=22)
      public 'speltid' => string '45 min' (length=6)
      public 'lokal' => string 'Spelyta exkl. sittplatser: 6x8x2,5m' (length=35)
      public 'period' => string 'Enligt överenskommelse.' (length=24)
      public 'pris' => string 'Pris i Halland: 1:a föreställningen: 1500 kr' (length=45)
  1 => 
    object(WP_Post)[6659]
      public 'ID' => int 608
      public 'post_author' => string '1' (length=1)
      public 'post_date' => string '2019-02-13 15:54:27' (length=19)
      public 'post_date_gmt' => string '2019-02-13 15:54:27' (length=19)
      public 'post_content' => string 'Lär dig att jonglera med både bollar och käglor' (length=47)
      public 'post_title' => string 'Lär dig jonglera' (length=16)
      public 'post_excerpt' => string '' (length=0)
      public 'post_status' => string 'publish' (length=7)
      public 'comment_status' => string 'closed' (length=6)
      public 'ping_status' => string 'closed' (length=6)
      public 'post_password' => string '' (length=0)
      public 'post_name' => string 'lar-dig-jonglera' (length=16)
      public 'to_ping' => string '' (length=0)
      public 'pinged' => string '' (length=0)
      public 'post_modified' => string '2019-03-13 13:44:16' (length=19)
      public 'post_modified_gmt' => string '2019-03-13 13:44:16' (length=19)
      public 'post_content_filtered' => string '' (length=0)
      public 'post_parent' => int 0
      public 'guid' => string 'http://exempel.se/?post_type=kulturprogram&#038;p=608' (length=53)
      public 'menu_order' => int 0
      public 'post_type' => string 'kulturprogram' (length=13)
      public 'post_mime_type' => string '' (length=0)
      public 'comment_count' => string '0' (length=1)
      public 'filter' => string 'raw' (length=3)
      public 'url' => string 'http://exempel.se/kulturprogram/lar-dig-jonglera/' (length=50)
      public 'image' => string '' (length=0)
      public 'image_url' => boolean false
      public 'date' => string '2019-02-13' (length=10)
      public 'labels' => 
        array (size=2)
          0 => 
            array (size=1)
              'label' => string 'Konst' (length=5)
          1 => 
            array (size=1)
              'label' => string 'Kulturarv' (length=9)
      public 'malgrupp' => string 'Både vuxna och barn' (length=20)
      public 'publik' => string 'Hela familjen är välkommen!' (length=29)
      public 'speltid' => string '120 minuter' (length=11)
      public 'lokal' => string 'Stora hallen' (length=12)
      public 'period' => string 'Under mars månad' (length=17)
      public 'pris' => string '120 kronor' (length=10)

Special-ista för enskilda label-arrayer via "Blade"

OBS! Det finns en array för respektive label, dvs för dans, film, konst, kulturarv, musik, slöjd och teater. Nedan exempel för arrayen dans. Övriga fungerar likadant. Notera att arrayen för slöjd stavas med o, dvs slojd

<h3>Dans</h3>
@foreach($myItems['dans'] as $item)
  <li>
    <p><a href="{{ $item['page']->url }}">{{ $item['page']->post_title }}</a></p>
    <p><strong>Målgrupp:</strong> {{ $item['page']->malgrupp }}</p>
  </li>
@endforeach

Exempel på array för special-listan

array (size=2)
  0 => 
    array (size=1)
      'page' => 
        object(WP_Post)[6653]
          public 'ID' => int 3621
          public 'post_author' => string '21' (length=2)
          public 'post_date' => string '2019-03-25 15:50:43' (length=19)
          public 'post_date_gmt' => string '2019-03-25 15:50:43' (length=19)
          public 'post_content' => string 'Ett ovanligt dansäventyr på en helt vanlig lekplats' (length=51)
          public 'post_title' => string 'The Playground (2–6 år)' (length=26)
          public 'post_excerpt' => string '' (length=0)
          public 'post_status' => string 'publish' (length=7)
          public 'comment_status' => string 'closed' (length=6)
          public 'ping_status' => string 'closed' (length=6)
          public 'post_password' => string '' (length=0)
          public 'post_name' => string 'the-playground-2-6-ar' (length=21)
          public 'to_ping' => string '' (length=0)
          public 'pinged' => string '' (length=0)
          public 'post_modified' => string '2019-03-25 15:50:43' (length=19)
          public 'post_modified_gmt' => string '2019-03-25 15:50:43' (length=19)
          public 'post_content_filtered' => string '' (length=0)
          public 'post_parent' => int 0
          public 'guid' => string 'http://exempel.se/?post_type=kulturprogram&#038;p=3621' (length=54)
          public 'menu_order' => int 0
          public 'post_type' => string 'kulturprogram' (length=13)
          public 'post_mime_type' => string '' (length=0)
          public 'comment_count' => string '0' (length=1)
          public 'filter' => string 'raw' (length=3)
          public 'url' => string 'http://exempel.se/kulturprogram/the-playground-2-6-ar/' (length=52)
          public 'labels' => 
            array (size=1)
              0 => 
                array (size=1)
                  'label' => string 'Dans' (length=4)
          public 'malgrupp' => string '' (length=0)
  1 => 
    array (size=1)
      'page' => 
        object(WP_Post)[6654]
          public 'ID' => int 4038
          public 'post_author' => string '11' (length=2)
          public 'post_date' => string '2019-03-25 07:53:02' (length=19)
          public 'post_date_gmt' => string '2019-03-25 07:53:02' (length=19)
          public 'post_content' => string 'En färgstark musikalisk dansföreställning!' (length=42)
          public 'post_title' => string 'Vilja Växa' (length=11)
          public 'post_excerpt' => string '' (length=0)
          public 'post_status' => string 'publish' (length=7)
          public 'comment_status' => string 'closed' (length=6)
          public 'ping_status' => string 'closed' (length=6)
          public 'post_password' => string '' (length=0)
          public 'post_name' => string 'vilja-vaxa' (length=10)
          public 'to_ping' => string '' (length=0)
          public 'pinged' => string '' (length=0)
          public 'post_modified' => string '2019-03-25 15:51:12' (length=19)
          public 'post_modified_gmt' => string '2019-03-25 15:51:12' (length=19)
          public 'post_content_filtered' => string '' (length=0)
          public 'post_parent' => int 0
          public 'guid' => string 'http://exempel.se/?post_type=kulturprogram&#038;p=4038' (length=54)
          public 'menu_order' => int 0
          public 'post_type' => string 'kulturprogram' (length=13)
          public 'post_mime_type' => string '' (length=0)
          public 'comment_count' => string '0' (length=1)
          public 'filter' => string 'raw' (length=3)
          public 'url' => string 'http://exempel.se/kulturprogram/vilja-vaxa/' (length=41)
          public 'labels' => 
            array (size=1)
              0 => 
                array (size=1)
                  'label' => string 'Dans' (length=4)
          public 'malgrupp' => string '3–6 år/familj' (length=16)

Visa data är arkivsidan via "Blade"

@php($myArcive = get_region_halland_acf_page_kulturprogram_archive_page())
  @if($myArcive['arkiv_image_large_url'] == 1)
    <img src="{{ $myArcive['arkiv_image_large_url'] }}" width="{{ $myArcive['arkiv_image_large_width'] }}" height="{{ $myArcive['arkiv_image_large_height'] }}"><br>
  @endif
  <h1>{{ $myArcive['arkiv_titel'] }}</h1><br><br>
  <span>{{ $myArcive['arkiv_ingress'] }}</span><br><br>
  <span>{{ $myArcive['arkiv_content'] }}</span><br><br>

Exempel på array arkiv-sidan

array (size=9)
  'arkiv_has_image' => int 1
  'arkiv_image_large_url' => string 'http://dev-regionhalland-nytt-tema.local/app/uploads/2020/11/minbild.jpg' (length=72)
  'arkiv_image_large_width' => int 562
  'arkiv_image_large_height' => int 602
  'arkiv_image_large_alt' => string 'Min alttext' (length=11)
  'arkiv_image_large_caption' => string 'Min captiontext' (length=15)
  'arkiv_titel' => string 'Nya spaningar' (length=13)
  'arkiv_ingress' => string 'Nya spaningar Ingress' (length=21)
  'arkiv_content' => string '<p>Nya spaningar Brödtext</p>' (length=31)

Versionhistorik

2.18.0

Justerat från nycirkus till cirkus

2.8.1

Tagit bort oönskat tecken

2.8.0

Lagt till en arkivsida med bild, titel, ingress och content

2.7.0

Lagt till visning av kategorier på posttypen kulturprogram

2.6.0

Justerat så att posttypen kulturprogram använder Gutenberg som editor

2.5.0

Lagt till publicering via Packagist
Justerat composer-namn

2.4.0

Lagt till "Nycirkus" som ny programtyp

2.3.0

Bifogat fil med licensmodell

2.2.0

Uppdaterat information om licensmodell
Uppdaterade länkar till repo

2.1.1

Sorterat om alla programtyper i bokstavsordning

2.1.0

Lagt till "Litteratur" som ny programtyp
Uppdaterade vy-filer
Sortering i bokstavordning för respektive program-array

2.0.0

Ändrat namn från kulturkatalog till kulturprogram
Fältet speltid heter istället längd

1.3.0

Special-lista med multiarrayer för varje label

1.2.0

Välja en eller flera typer, ex dans, film
funktion för att lista poster från kulturkatalogen

1.1.0

Adderat has_archive = true för att kunnna ha en arkiv-sida

1.0.0

Första version

regionhalland / region-halland-plugin-acf-page-kulturprogram

Maintainers

Details