Servicemenu

Samen overheidscommunicatie verbeteren!

  1. Home >
  2. Meedoen>
  3. Technische documentatie>
  4. Configuratie

Configuratie

Om vanuit uw eigen website Bouwen aan Brieven modules te kunnen tonen dient u eenmalig te configureren. Dit doet u door een script op uw eigen website te activeren, en deze aan te melden op het Bouwen aan Brieven platform.

Dit script is niet noodzakelijk voor Bouwen aan Brieven om te werken, met vergroot de gebruikersbeleving door afhankelijk van de schermgrootte van de gebruiker het ideale schermformaat voor de brief in te stellen. Indien dit script niet gebruikt wordt, verschijnen er schuifbalken (scrollbars) bij het bekijken van de brieven.

Bouwen aan Brieven is inmiddels succesvol getest met de volgende website systemen: Typo3, Greenvally, GX, Hippo, WordPress, Joomla en Drupal.

3 methoden plaatsen hulpscript

De scripts genoemd in deze pagina’s zijn ook als zip-file te downloaden.

1. Het plaatsen van een html bestand op uw website

De methode bestaat uit het uploaden van een bestand naar uw website.

  • Sommige website systemen, ookwel  contentmanagementsystemen (CMS), staan geen FTP toegang toe.
  • Via de beheertoegang van uw CMS kunnen vervolgens wel bestanden geplaatst worden zoals documenten en plaatjes, en op deze manier kan ook dit bestand geplaatst worden.
  • Sommige van deze CMS systemen blokkeren dit bestandstype (html), of staan enkel plaatjes en bekende document formaten zoals Word en PDF toe.

Vanwege deze omstandigheden kiezen de meeste gebruikers van Bouwen aan Brieven voor de tweede en derde optie.

2. Het plakken van code in een pagina op uw website

Hierbij wordt een script in een pagina geplakt.

  • Sommige website systemen verwijderen scripts uit de pagina’s. Dat betekent dat na inplakken en bewaren het script is verdwenen.
  • Wel staan sommige websystemen toe om gehele HTML pagina’s te koppelen of te laden, en methode 3 toont hoe dit zou kunnen.

3. Het koppelen of laden van de code middels een html file

Bij sommige CMS systemen is gebleken dat de makkelijkste manier om dit script in uw website tladen door het script aan te bieden als onderdeel van een html bestand.

  • Niet elk websysteem zal dit ondersteunen, bij Greenvally is dit de aanbevolen methode.

Methode 1:Het plaatsen van een html bestand op uw website.

<html>
<head/>
<body>
<div id="content">
	<script>
    function parentIframeResize(){
       var height = getParam('height');
       parent.parent.resizeIframe(height);
    }

   /* Helper function, parse param from request string */
    function getParam( name ){
      name = name.replace(/[\[]/,"\\\[").replace(/[\]]/,"\\\]");
  var regexS = "[\\?&amp;]"+name+"=([^&amp;#]*)";
      var regex = new RegExp( regexS );
      var results = regex.exec( window.location.href );
      if( results == null )
        return "";
      else
        return results[1];
    }
    parentIframeResize();
  </script>
</div>
</body>
</html>

Dit bestand kunt u maken middels bovenstaande code (klik ‘show sourcecode’).

Deze code kunt u vervolgens plakken in Notepad, een standaard platte textbewerker: En vervolgens kunt u dit tekst bestand opslaan.

Middels uw eigen FTP appplicatie (FileZilla, WSFTP) kunt u dit bestand vervolgens plaatsen op uw website in een bepaalde map. Noteert u wel even de lokatie van het bestand, deze heeft u later nodig.

Methode 2: Het plakken van javascript code in een pagina op uw website.

<script>
    function parentIframeResize(){
       var height = getParam('height');
       parent.parent.resizeIframe(height);
    }
    /* Helper function, parse param from request string*/
    function getParam( name ){
      name = name.replace(/[\[]/,"\\\[").replace(/[\]]/,"\\\]");
  var regexS = "[\\?&amp;]"+name+"=([^&amp;#]*)";
      var regex = new RegExp( regexS );
      var results = regex.exec( window.location.href );
      if( results == null )
        return "";
      else
        return results[1];
    }
    parentIframeResize();
  </script>

U kunt bovenstaande code kopiëren (zie ook de illustraties van methode 1), en vervolgens in uw website plakken. We geven een voorbeeld van hoe dit op de website van Bouwen aan Brieven werkt.

De plek waar pagina’s bewerkt en toegevoegd kunnen worden. Afhankelijk van uw eigen website en leverancier zal dit verschillen.

Door deze  code in een publiek toegankelijk pagina te plakken wordt deze beschikbaar gemaakt.

! Belangrijk is om dit in de zogenaamde ‘HTML’ modus van het pagina bewerken te doen.

! Controleer of het einderesultaat klopt. Dit kunt u doen door een preview te bekijken en dan de bron te bekijken. De code van dit script zou hierzichtbaar moeten zijn.

Methode 3: HTML pagina embedden

<html>
<head/>
<body>
<div class="contentarea" id="content">
	<script>
    function parentIframeResize(){
       var height = getParam('height');
       parent.parent.resizeIframe(height);
    }

    /* Helper function, parse param from request string*/
    function getParam( name ){
      name = name.replace(/[\[]/,"\\\[").replace(/[\]]/,"\\\]");
  var regexS = "[\\?&amp;]"+name+"=([^&amp;#]*)";
      var regex = new RegExp( regexS );
      var results = regex.exec( window.location.href );
      if( results == null )
        return "";
      else
        return results[1];
    }
    parentIframeResize();
  </script>
</div>
</body>
</html>

Bovengenoemde code kan worden gekopieerd naar Notepad en vervolgens als HTML bestand worden opgeslagen. Hierna kan deze ‘aangeboden’ worden aan uw website systeem, via een upload functie.

De lokatie van het script bekend maken bij het platform

Afhankelijk van de gekeuzen methode heeft uw een pagina of bestand op uw website waar het script te vinden is. Dit is een internet lokatie in het formaat (voorbeelden).

  • http://www.uwwebsite.nl/wp-content/themes/bab-child-theme/iframe/iframehelper.js (methode 1)
  • http://www.uwwebsite.nl/2010/10/dit-is-een-help-functie/ (methode 2 en 3)

Door in te loggen op het platform kunt u door navigeren naar ‘Algemeen’ en ‘Iframehelper’. Hier kunt u deze lokatie invoegen.

Het melden van de lokatie van het hulpscript.