README

Hur man använder Region Hallands plugin "RhAcfPageLinksBlurbs"

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

Användningsområde

Denna plugin skapar en posttyp med namn "Puffar". Dessa puffar kan man sedan välja att visa på en sida.

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/RhAcfPageLinksBlurbs?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/RhAcfPageLinksBlurbs

Läs in pluginen via composer

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

"require": {
  "regionhalland/region-halland-plugin-acf-page-links-blurbs": "1.0.0"
},

Loopa ut länkarna via "Blade"

@php($myBlurbs = get_region_halland_acf_main_post_page_links_blurbs())
@if(isset($myBlurbs))
  <h1>{{ $myBlurbs['rubrik'] }}</h1>
  @foreach ($myBlurbs['blurbs'] as $blurbs)
    <span><a href="{{ $blurbs['post_url'] }}">{{ $blurbs['post_name'] }}</a></span><br>
    <span>{!! $blurbs['image'] !!}</span><br>
    <span>{{ $blurbs['post_title'] }}</span>
    <span>{{ $blurbs['post_content'] }}</span>
    <span><a href="{{ $blurbs['link_url'] }}" target="{{ $blurbs['link_target'] }}">{{ $blurbs['link_title'] }}</a></span><br>
  @endforeach
@endif

Använd ett ID

Man kan välja att använda ett id (för en sida) när man hämtar ut puffar
Default är dock utan ID

@php($myBlurbs = get_region_halland_acf_main_post_page_links_blurbs(116))

Exempel på hur arrayen kan se ut

array (size=2)
  'rubrik' => string 'Min puffrubrik' (length=14)
  'blurbs' =>
    array (size=3)
      0 =>
        array (size=12)
          'ID' => int 218
          'post_url' => string 'http://dev-template.local/puffar/puff-a/' (length=40)
          'post_name' => string 'Puff A' (length=6)
          'post_title' => string 'Puff A' (length=6)
          'post_content' => string 'Lorem ipsum' (length=11)
          'image' => string '<img width="640" height="332" src="http://dev-template.local/app/uploads/2020/03/utbildning_aa_large.jpg" class="attachment-post-thumbnail size-post-thumbnail wp-post-image" alt="" srcset="http://dev-template.local/app/uploads/2020/03/utbildning_aa_large.jpg 640w, http://dev-template.local/app/uploads/2020/03/utbildning_aa_large-300x156.jpg 300w" sizes="(max-width: 640px) 100vw, 640px" />' (length=391)
          'image_url' => string 'http://dev-template.local/app/uploads/2020/03/utbildning_aa_large.jpg' (length=69)
          'image_alt' => string '' (length=0)
          'has_link' => int 1
          'link_title' => string 'Extrainfo 1' (length=11)
          'link_url' => string 'http://dev-template.local/extrainfo/extrainfo-1/' (length=48)
          'link_target' => string '' (length=0)
      1 =>
        array (size=12)
          'ID' => int 219
          'post_url' => string 'http://dev-template.local/puffar/puff-b/' (length=40)
          'post_name' => string 'Puff B' (length=6)
          'post_title' => string 'Puff B' (length=6)
          'post_content' => string 'Lorem ipsum B' (length=13)
          'image' => string '<img width="640" height="330" src="http://dev-template.local/app/uploads/2020/03/utbildning_large.jpg" class="attachment-post-thumbnail size-post-thumbnail wp-post-image" alt="" srcset="http://dev-template.local/app/uploads/2020/03/utbildning_large.jpg 640w, http://dev-template.local/app/uploads/2020/03/utbildning_large-300x155.jpg 300w" sizes="(max-width: 640px) 100vw, 640px" />' (length=382)
          'image_url' => string 'http://dev-template.local/app/uploads/2020/03/utbildning_large.jpg' (length=66)
          'image_alt' => string '' (length=0)
          'has_link' => int 1
          'link_title' => string 'Extrainfo 2' (length=11)
          'link_url' => string 'http://dev-template.local/extrainfo/extrainfo-2/' (length=48)
          'link_target' => string '' (length=0)
      2 =>
        array (size=12)
          'ID' => int 220
          'post_url' => string 'http://dev-template.local/puffar/puff-c/' (length=40)
          'post_name' => string 'Puff C' (length=6)
          'post_title' => string 'Puff C' (length=6)
          'post_content' => string 'Lorem ipsum C' (length=13)
          'image' => string '<img width="400" height="180" src="http://dev-template.local/app/uploads/2019/10/exempel_1.jpg" class="attachment-post-thumbnail size-post-thumbnail wp-post-image" alt="" srcset="http://dev-template.local/app/uploads/2019/10/exempel_1.jpg 400w, http://dev-template.local/app/uploads/2019/10/exempel_1-300x135.jpg 300w" sizes="(max-width: 400px) 100vw, 400px" />' (length=361)
          'image_url' => string 'http://dev-template.local/app/uploads/2019/10/exempel_1.jpg' (length=59)
          'image_alt' => string '' (length=0)
          'has_link' => int 1
          'link_title' => string 'Extrainfo 3' (length=11)
          'link_url' => string 'http://dev-template.local/extrainfo/extrainfo-3/' (length=48)
          'link_target' => string '' (length=0)

Hämta ut en enskild "blurb" via Blade

@php($myBlurb = get_region_halland_acf_page_links_single_blurb(116))
@if(isset($myBlurb))
    <span><a href="{{ $blurb->post_url }}">{{ $blurb->post_title }}</a></span><br>
    <span>{!! $blurb->image !!}</span><br>
    <span>{{ $blurb->post_content }}</span>
    <span><a href="{{ $blurb->link_url }}" target="{{ $blurb->link_target }}">{{ $blurb->link_title }}</a></span><br>
 @endif

Exempel på "enskild" array

object(WP_Post)[6859]
  public 'ID' => int 116
  public 'post_author' => string '1' (length=1)
  public 'post_date' => string '2019-02-28 09:33:41' (length=19)
  public 'post_date_gmt' => string '2019-02-28 08:33:41' (length=19)
  public 'post_content' => string 'Vestibulum ante ipsum primis in faucibus orci luctus et ultrices.' (length=65)
  public 'post_title' => string 'Min andra puff' (length=14)
  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 'min-andra-puff' (length=14)
  public 'to_ping' => string '' (length=0)
  public 'pinged' => string '' (length=0)
  public 'post_modified' => string '2019-03-06 12:57:43' (length=19)
  public 'post_modified_gmt' => string '2019-03-06 11:57:43' (length=19)
  public 'post_content_filtered' => string '' (length=0)
  public 'post_parent' => int 0
  public 'guid' => string 'http://exempel.se/?post_type=blurbs&#038;p=116' (length=46)
  public 'menu_order' => int 0
  public 'post_type' => string 'blurbs' (length=6)
  public 'post_mime_type' => string '' (length=0)
  public 'comment_count' => string '0' (length=1)
  public 'filter' => string 'raw' (length=3)
  public 'url' => string 'http://stage-demo.local/puffar/min-andra-puff/' (length=46)
  public 'image' => string '<img width="400" height="180" src="http://stage-demo.local/app/uploads/2018/11/nyhet_2.jpg" class="attachment-post-thumbnail size-post-thumbnail wp-post-image" alt="" srcset="http://stage-demo.local/app/uploads/2018/11/nyhet_2.jpg 400w, http://stage-demo.local/app/uploads/2018/11/nyhet_2-300x135.jpg 300w" sizes="(max-width: 400px) 100vw, 400px" />' (length=349)
  public 'image_url' => string 'http://exempel.se/app/uploads/2018/11/nyhet_2.jpg' (length=55)
  public 'link_title' => string 'Go to google' (length=12)
  public 'link_url' => string 'http://www.google.com' (length=21)
  public 'link_target' => string '_blank' (length=6)

Versionhistorik

1.10.0

ACF fälten visas nu i WP JSON REST APIet

1.9.2

Korrigerat så att posttypen inte längre är publik, dvs att man inte längre kan se posterna som singelsidor

1.9.1

Puffar visas även på sidan för enheter

1.9.0

Lagt till så att kategories visas för puffar

1.8.4

Förbättra hjälptexter

1.8.3

Returnera även bild ID i get_region_halland_acf_main_post_page_links_blurbs()

1.8.2

Ännu en kontroll för att inte skicka ut ospecificerade blurbs

1.8.1

Lagt till en kontroll om man har valt någon blurb

1.8.0

Lagt till puffrubrik

1.7.1

Uppdaterat readme

1.7.0

Bifogat fil med licensmodell

1.6.0

Uppdaterat information om licensmodell
Uppdaterade länkar till repo

1.5.0

Hämtar ut alt-texten för en bild vid listning av alla

1.4.2

Bugg med postdata åtgärdad. Blev fel global post.

1.4.1

Bugg med if-sats åtgärdad

1.4.0

Möjlighet att ange ID när man hämtar ut puffar

1.3.1

Lagat error om man inte har angett någon länk i puffen

1.3.0

Adderat post_title till arrayen som hämtas ut

1.2.1

Lagade error om en sida saknar puffar, returnerar då en tom array

1.2.0

Funktion för att hämta enskild blurb

1.1.0

Lagt till ACF-länk på puff-sidan

1.0.0

Första version

regionhalland / region-halland-plugin-acf-page-links-blurbs

Maintainers

Details