regionhalland / region-halland-plugin-nps-form

v1.7.0 2020-07-31 07:38 UTC

GPL-3.0

• Roland Hydén

Published on Packagist.org on 2020-07-31 07:39 UTC

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