README

Hur man använder Region Hallands plugin "RhNpsForm"

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

Användningsområde

Denna plugin skapar ett formulär i admin för att spara NPS-data

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

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/RhNpsForm"
  },
],

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-nps-form": "1.0.0"
},

Lägg till formuläret på en sida

{{-- NPS --}}
@include('partials.region-halland-nps-show-form')

Partial som visar formuläret ser ut enligt:

@if(function_exists('show_region_halland_nps_form'))
	@php($myNpsShowForm = show_region_halland_nps_form())
	@if($myNpsShowForm == 1)
		<?php
			$myHasSubmittedNps = 0;
			if(isset($_POST["has-submitted-nps"])){
		        $myHasSubmittedNps = $_POST["has-submitted-nps"];
		    }
		?>
		@if($myHasSubmittedNps == 0)
			<form method="post" action="./">
				<h2>Hur bra var denna sidan</h2>
				<input type="hidden" name="has-submitted-nps" value="1">
				<input type="hidden" name="ID" value="{{$post->ID}}">
				<input type="radio" value="1" class="" name="my-nps-value">1
				<input type="radio" value="2" class="" name="my-nps-value">2
				<input type="radio" value="3" class="" name="my-nps-value">3
				<input type="radio" value="4" class="" name="my-nps-value">4
				<input type="radio" value="5" class="" name="my-nps-value">5
				<input type="radio" value="6" class="" name="my-nps-value">6
				<input type="radio" value="7" class="" name="my-nps-value">7
				<input type="radio" value="8" class="" name="my-nps-value">8
				<input type="radio" value="9" class="" name="my-nps-value">9
				<input type="radio" value="10" class="" name="my-nps-value">10<br><br>
				<textarea class="" name="my-nps-text"></textarea><br><br>
				<input type="submit" class="rh-button" value="SKICKA">
			</form>
		@else
			<p>Tack för din nps-kommentar!</p>
		@endif
	@endif
@endif

Beräkna regler och Spara formulär-data

OBS! Lägg in detta i app.blade.php, dvs högst upp

@include('partials.region-halland-nps-form-save-form')

Partial som håller koll på regler och postar datan ser ut enligt:

OBS! Detta betyder att :
funktionen "rules_region_halland_nps_form()" hela tiden uppdaterar en session med vilka sidor man besöker
funktionen "region_halland_nps_form_save_form()" hela tiden "sniffar" efter om någon postar formulär-data

@if(function_exists('rules_region_halland_nps_form'))
	@php(rules_region_halland_nps_form())
@endif
@if(function_exists('region_halland_nps_form_save_form'))
	@php(region_halland_nps_form_save_form())
@endif

Två endpoints för att spara data

Notera att npa-save-number returnerar en uniqueID som behövs för att spara text

http://[SITE-URL]]/app/plugins/region-halland-nps-form/endpoints/nps-save-number.php
http://[SITE-URL]/app/plugins/region-halland-nps-form/endpoints/nps-save-text.php

Exempel på formulär

För att spara nummer och skapa själva posten

<form method="post" action="http://[SITE-URL]/app/plugins/region-halland-nps-form/endpoints/nps-save-number.php">
<input type="hidden" name="has-submitted-nps-number" value="1">
<input type="hidden" name="ID" value="{{$post->ID}}">
<input type="radio" value="7" class="" name="my-nps-value">7
<input type="submit" class="rh-button" value="SKICKA">
</form>

För att spara text med identifier

<form method="post" action="http://[SITE-URL]/app/plugins/region-halland-nps-form/endpoints/nps-save-text.php">
<input type="hidden" name="has-submitted-nps-text" value="1">
<input type="hidden" name="ID" value="{{$post->ID}}">
<input type="hidden" name="my-nps-identifier" value="202060650420981910523">
<input type="text" value="Lorem ipsum" class="" name="my-nps-text">
<input type="submit" class="rh-button" value="SKICKA">
</form>

Versionhistorik

1.7.0

Korrigerat en bugg i visningen av sämsta sidor på dashboard

1.6.3

Korrigera numrering av sämsta sidor på dashboard

1.6.2

Korrigerade visningen av enskilda inskickade betyg i admin

1.6.1

Lade till check för att se att post är satt så att plugin inte triggas på exempelvis 404

1.6.0

Lagt till kommentarer inuti NPS metarutan på page-nivå

1.5.0

Justerat namn på cookie från "cookie_nps_form" till "rh_cookie_nps_form"

1.4.1

la till valign="top" på datum/kommentarer för bättre utseende vi mycket text

1.4.0

Lagt till en widget som visar alla kommentarer i datumordning efter nyast först

1.3.2

Kapade text efter 500 tecken + intval() på alla numeriska fält

1.3.1

Justerade från return till eco i endpoints

1.3.0

Två endpoints med spara nummer resp spara text

1.2.3

Uppdaterade två felstavde variabelnamn

1.2.2

Fel namn på en sessionsvariabel åtgärdat

1.2.1

Lagade en felstavning

1.2.0

Lagt till dashboard widgets
Lagt till kolumn med NPS-data i sid-listning
Lagt till meta_box med NPS-data på edit-sida

1.1.0

Uppdaterade regler och nya funktioner

1.0.0

Första version

regionhalland / region-halland-plugin-nps-form

Maintainers

Details