Custom scripting binnen RSForm!Pro - JoomlaDagen 2018

Custom scripting binnen RSForm!Pro - JoomlaDagen 2018
Frits Jongbloets Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Custom scripting... wat? Voorbeeldje: * Webformulier om info aan te vragen * Checkboxen dynamisch genereren: titels van artikelen uit bepaalde categorie Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Over mij * Frits Jongbloets * Studio De Oorzaak en * De Webcompagnons (met Anja de Crom en Joris Lange) * Websites voor klanten * Joomla sinds 2008 * Ik programmeer eigen aanpassingen aan Joomla en/of extensies via overrides of plugins en RSform!Pro biedt daar heel leuke opties voor Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Over jullie Zijn jullie bekend met: * Het maken van webformulieren ? * RSForm!Pro ? * Custom scripting binnen RSForm!Pro ? * Javascript ? * php / mySql ? Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Heb je vragen? * Vragen ter verduidelijking: Stel ze meteen * Andere vragen: graag aan eind van de presentatie Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Ja * Deze presentatie is na de JD te downloaden * En ook de code van de voorbeelden Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Waar te beginnen * Documentatie website RSJoomla * Veel voorbeelden: hoe kan ik... * Maar: verwarrend veel zones voor code in elk formulier * Poging tot orde aanbrengen hierin! Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Fasen van een webformulier Formulier staat klaar Gebruiker voert in Gebruiker stuurt invoer op Bedank bericht / resultaatpagina s Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Scripting in deze fasen Formulier staat klaar Gebruiker voert in Gebruiker stuurt invoer op Bedank bericht / resultaatpagina s Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Inhoud * Voorbeelden per fase formulier Voorbereiden (klaarzetten) formulier Ondersteunen invoer (real time) Verwerken invoer Na de verwerking van de invoer s versturen * Tips * De scripting-zones op een rijtje * Snelle impressie RSForm!Pro * Bronnen Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Voorbereiden formulier: individuele velden * Veldtype: "Vrije tekst" -> mededelingen, geen invoer * In attribuut Tekst de code toevoegen * Voorbeeld 1.a (formulier: Is de gebruiker ingelogd?) Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Algemene principes bij individueel veld * Script staat tussen deze tags: // <code> // </code> * De output wordt naar formulier gestuurd met: return $output ; * Specifieke Joomla functies / classes aanroepen, bijv.: $user = JFactory::getUser(); Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Checkboxen aanmaken vanuit database * Veldtype: "Checkbox groep" * Hetzelfde principe als radio buttons en select lijsten * In dit geval: titels van meerdere Joomla artikelen * Voorbeeld 1.b (formulier: Checkboxen vullen) Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Principes bij checkboxen aanmaken * Een array klaarzetten voor alle gevonden waardes $options = array(); * Gevonden waardes in array zetten via een loop foreach($results as $result) { ... } * Waarden in de array met pipe teken scheiden van tekst: $result->id . '|' . $result->title; * Als array gevuld is, omzetten naar tekst met regeleindes $options = implode("\n", $options); Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Voorbereiden formulier: scripting zone voor hele formulier * Eigenschappen > Scripts * Zone "Script wat opgeroepen wordt wanneer het formulier zichtbaar is" * $formLayout bevat HTML code van het formulier * Bewerken, bijvoorbeeld met zoek / vervang Voorbeeld 1.c (formulier: Is de gebruiker ingelogd?) Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Scripting zone voor hele formulier * Bij tekstvelden placeholder in standaard waarde * Met één script alle placeholders aanpassen * Minder database calls Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Ondersteunen invoer: beschikbaar aantal lettertekens * Veld met bijv. maximaal 40 tekens * RSForm!Pro kan dit native controleren bij inzenden * Met JavaScript directe feedback aan gebruiker * In voorbeeld: controle na elke ingetoetste letter * Voorbeeld 2 (formulier: Aantal resterende tekens & Extern script) Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Principes van Javascript ondersteuning (1) * De velden heten: regel1, regel2, regel3 * In elk dit additionele attribuut met aangepast nummer: onKeyUp="textCounter(regel1,remaining1,40)" * Onder elk veld een html element met nummer: <input id="remaining1" readonly> * Dit element heeft als standaard inhoud: Beschikbaar aantal lettertekens: 40 Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Principes van Javascript ondersteuning (2) * In de Javascript zone van het formulier staat: <script> function textCounter(source,display,limit){...} </script> * Resterend aantal tekens wordt gemeten met: var remaining = limit - source.value.length; * Als resterend aantal 0 is, wordt tekst afgekapt * Bij elke toetsaanslag wordt resterend aantal zichtbaar gemaakt Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

RSForm!Pro eigen voorbeelden * Ook patches op ontbrekende functionaliteit? Bijv.: Wissen van conditioneel getoonde velden Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Verwerken invoer * Zone voor scripts op niveau hele formulier * Mogelijkheden o.a.: - Bewerken van ingevoerde tekst - Invoer opslaan in een andere databasetabel dan die van RSForm!Pro * De invoer van het formulier zit in deze array: $_POST['form'] * Je kunt deze array wijzigen voordat hij verwerkt wordt * Voorbeeld 3 (formulier: Artikel insturen) Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Na verwerking invoer * RSForm!Pro geeft na verzending een 'bedankbericht' (als dat ingesteld staat) * RSForm!Pro slaat invoer op in database * De submission krijgt een id binnen RSForm!Pro * Als je iets met submission-id wilt doen -> kan pas na verwerking invoer Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Na verwerking invoer: Bedankbericht aanpassen * Kan gecombineerd worden met algemene optie voor bedankbericht: Eigenschappen > Wijzig formulier > Wijzig het bedankt bericht * Algemene optie werkt met placeholders * In script zone is bedankbericht één tekststring: $thankYouMessage * Hierin zoeken/vervangen * Of tekst ervoor of erachter zetten * Voorbeeld 4.a (formulier: Artikel insturen) Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Na verwerking invoer: Extern custom script * Eerst verwerking zodat input in RSForm!Pro database tabellen staat * Vervolgens uitgebreid eigen script starten; input uit formulier hieraan meegeven * Omwille van de complexiteit en samenhang met plugin gekozen voor extern php-bestand * Voorbeeld 4.b (formulier: Aantal resterende tekens & Extern script) Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Principes extern script aanroepen * Eigen php bestand in een map plaatsen * Hierin een eigen php class definiëren * Bestand aanroepen als: require_once('/pad_naar_de_map/bestandsnaam.php'); * Pad naar de map is server pad, geen url! * Maak instance van je eigen php class $obj = new myPhpClass(); * Voer de methode van je php class uit $output = $obj->doSomething($SubmissionId); Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

s versturen * Werkwijze vergelijkbaar met bedankbericht * RSForm!Pro native opties voor versturen van mails: - Eigenschappen > Gebruiker s > Wijzig de tekst - Eigenschappen > Administrator s > Wijzig de tekst - Eigenschappen > Additionele s * In native opties: placeholders * In script zones een variabele per mail: $user , $admin (allebei strings) $additional (array) * GEEN VOORBEELD Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Code highlighting aanzetten * Werkt in script zones per formulier, niet per veld * Configuratie > Tabblad Instellingen > Activeer syntax highlighting: Ja Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Kopiëren / plakken vanuit externe code editor * Gebruik een goede code editor (bijv. PhpStorm) * Ondersteuning bij werken met code * Werk in een 'klad' bestandje * Kopiëren / plakken naar zone in RSForm!Pro * Debuggen in RSForm!Pro Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Wel / niet open- en sluittags gebruiken * php / mySql individueel veld: // <code> // </code> * Javascript zone hele formulier: <script> </script> * php / mySql zones hele formulier: GEEN open- en sluittags Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Debugging in formulieren * Debuggen van scripts in formulieren is tijdrovend * Algemene tip: tijdelijk velden depubliceren die voor je script niet relevant zijn Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Debugging Javascript * In Javascript output naar console laten schrijven: console.log('Remaining: ' + remaining); * In je browser de developer console bekijken: Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Debugging php / mySql * Vereist onderbreken van php met exit() of die() * Dit zal je eigen script, het hele formulier en ook Joomla onderbreken op dat punt var_dump($results); die(); * Voorbeeld van output: Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Waar laten we de custom scripts? Verschillende zones * Zones per veld (Tab Componenten > per veld): - Standaard waarde / Tekst - Additionele attributen * Zones per formulier (Tab Eigenschappen): - JavaScript zone - 3 zones voor / tijdens / na verwerking form - 3 zones bewerking s Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Script zones per veld * Standaard waarde / Tekst (in geval van Vrije tekst-veld) - php en mySql (voorbereiden formulier) Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Script zones per veld * Additionele attributen - Javascript triggers die Javascript functies aanroepen; directe feedback tijdens invullen formulier Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Script zones per formulier * Eigenschappen > CSS en Javascript - Javascript functies (worden getriggerd vanuit velden) - Bevindt zich onder zone voor custom css Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Script zones per formulier * Eigenschappen > Scripts, php / mySql, indeling in: - Voorbereiding formulier (bij 'binnenkomst' op pagina) - Tijdens verwerking (vóór opslaan in database) - Na verwerking van de invoer (na opslaan in database) Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Script zones per formulier * Eigenschappen > scripts, php / mySql, indeling: - mails aan gebruiker, admin of aanvullende s Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

* Formulieren-extensie voor Joomla * * Pro versie kost geld * Er is ook een Free versie * Workshop Anja de Crom en René Kreijveld (gisteren...) Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

* Lijst van formulieren
Impressie back-end * Lijst van formulieren Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Impressie back-end * Formulier bewerken - Taalswitch! -"Tabbladen" Componenten - Eigenschappen Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Impressie back-end * Veld bewerken (in een pop-up venster) - Verschillende opties voor custom scripting Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Impressie back-end * Tabblad Componenten: velden toevoegen / bewerken - o.a. zones voor custom scripting per veld Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Impressie back-end * Tabblad Eigenschappen: alle andere opties - o.a. zones voor custom scripting op formulier-niveau Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Voordelen van RSForm!Pro i.c.m. eigen code + RSForm!Pro is een stabiel product + RSForm!Pro heeft al veel functionaliteit + RSForm!Pro heeft integraties voor andere extensies o.a. betaalsystemen, MailChimp, GoogleMaps + "Onbeperkte mogelijkheden" voor eigen scripts, je kunt bijna een eigen extensie ermee maken + Custom scripts worden in het formulier opgeslagen + Custom scripts zijn veilig bij updates + Goede support bij betaalde subscription Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Nadelen van RSForm!Pro i.c.m. eigen code - RSForm!Pro interface en vormgeving stug en "nerdy" - Soms kleine veldjes voor je code - Hier en daar wat eigenaardigheden - Geen ingebouwde editor, beperkte code highlighting - Debugging binnen een formulier soms lastig Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Informatiebronnen RSForm!Pro * Algemene info en aanschaf RSForm!Pro * Documentatie RSForm!Pro met voorbeelden: * Forum van RSJoomla: Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Informatie over enkele Joomla classes * Joomla database object * Joomla user object Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Google is je vriend (of Duckduckgo, of ...) * Veel code snippets online (php, mySql, Javascript) * Copy / paste / edit programmeren * Soms even creatief aanpassen aan jouw situatie Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Bonus info In verband met AVG wetgeving heeft Peter Martin (db8) een script gemaakt om alle binnengekomen formulieren van RSForm!Pro na een maand te verwijderen: * Dit is een cli script, moet in map /cli geplaatst worden en aangeroepen worden met een cron job * Het script werkt maar geeft momenteel een (onterechte) foutmelding, wordt nog opgelost Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Download deze presentatie en de voorbeeldscripts (Zo snel mogelijk na de JoomlaDagen) Custom scripting binnen RSForm!Pro - JoomlaDagen 2018 Frits Jongbloets - Studio De Oorzaak / de Webcompagnons -

Custom scripting binnen RSForm!Pro - JoomlaDagen 2018

Verwante presentaties

Presentatie over: "Custom scripting binnen RSForm!Pro - JoomlaDagen 2018"— Transcript van de presentatie:

Verwante presentaties

Over het project

Feedback

Inloggen

Inloggen via een sociaal netwerk:

Custom scripting binnen RSForm!Pro - JoomlaDagen 2018

Verwante presentaties

Presentatie over: "Custom scripting binnen RSForm!Pro - JoomlaDagen 2018"— Transcript van de presentatie:

Verwante presentaties

Over het project

Feedback