Differences

This shows you the differences between two versions of the page.

--- dvg7:functionaliteit:afvalkalender [2018/11/07 06:53] – aangemaakt root
+++ dvg7:functionaliteit:afvalkalender [2024/01/17 15:02] (current) – external edit 127.0.0.1
@@ Line 4: / Line 4: @@
 Het is ook mogelijk om een verzoek om afval op te halen in te schieten.
+De standaard url voor de kalender is: /trash-removal-calendar
+Als een postcode bekend is uit cookie of formulier wordt de url: /trash-removal-calendar/[POSTCODE]/[NUMMER], bv /trash-removal-calendar/4921MA/2
 ===== Waar dient het voor? =====
 Burgers informeren wanneer ze afval aan de gemeente aan kunnen leveren.
+{{:dvg7:functionaliteit:dvg_trash_printscreen.png?nolink&600|}}
 ===== Data importeren =====
@@ Line 15: / Line 19: @@
 De gegevens voor de afvalkalender worden geïmporteerd via /admin/content/trash-calendar/import.
 Hier moeten twee bestanden aangeboden worden:
-  * "Afvaltypen per dag bestand": dit is een komma-gescheiden bestand (csv)\\Bevat de definitie van routes en op welke dag deze opgehaald worden.
+  * "Afvaltypen per dag bestand": dit is een komma-gescheiden bestand (csv)\\ Bevat de definitie van routes en op welke dag deze opgehaald worden.
-  * "Postcode data bestand": dit is een komma-gescheiden bestand (csv)\\Bevat alle postcode (gebieden) met de routes die aan deze postcodes gekoppeld zijn. Elke postcode kan meerdere routes hebben, b.v. een aparte route voor papier.
+  * "Postcode data bestand": dit is een komma-gescheiden bestand (csv)\\ Bevat alle postcode (gebieden) met de routes die aan deze postcodes gekoppeld zijn. Elke postcode kan meerdere routes hebben, b.v. een aparte route voor papier.
+{{ :dvg7:functionaliteit:trash_data.zip |Download hier voorbeeldbestanden...}}
+==== Afvaltypen per dag bestand ====
+De trash collection data file moet in ieder geval de volgende kolommen bevatten:
+  * "Datum" (of Engels: "Date")
+  * Per **afvaltype** een kolom waarin de naam van de route is opgenomen. De titel van de kolom moet overeen komen met de trash type mapping die is ingesteld voor de site. (Deze kan alleen door uw leverancier ingesteld worden.) De exacte namen vind u in de toelichting onder het upload-veld\\ {{:dvg7:functionaliteit:dvg_trash_afvalroutes.png?nolink&400|}}\\ Standaard afvaltypen van de module zijn:
+    * residual
+    * bio
+    * plastic
+    * paper\\ De waarden in de kolom bevatten de naam van de route, als er op die dag opgehaald dient te worden. Deze route namen kan u zelf verzinnen en zoveel aanmaken als u wil, het is alleen belangrijk dat u dezelfde namen gebruikt in het andere bestand. Gebruik "iedereen" als die datum voor alle postcodes geld.\\ {{:dvg7:functionaliteit:dvg_trash_routenamen_vs_afvaltypen.png?nolink&600|}}
+  * "Afwijkend" (of Engels: "Different") (optioneel).\\ Deze kolom geeft aan of de betreffende datum afwijkend is van de standaard ophaaldagen. Dit kan bijvoorbeeld gebruikt worden om aan de bezoeker te tonen of het hier gaat om een dag die is verplaatst vanwege een feestdag o.i.d. Als hier "Ja" staat, wordt in de kalender duidelijk aangegeven dat dit een afwijkende ophaaldag is zodat de burger dat goed herkent.
+Voorbeeld:\\
+{{:dvg7:functionaliteit:dvg_trash_dagen_voorbeeld.png?nolink&400|}}
+De kolom "Dag" in dit voorbeeld bevat informatie die bij de import niet wordt meegenomen. Deze kolomnaam kan worden opgegeven als "ignore column", zodat deze ook geen melding geeft bij het importeren van het bestand. (Dit moet door uw leverancier ingesteld worden.)
+Als een datum regel geen route informatie bevat (in dit voorbeeld op zondag 2018-01-07), dan wordt deze bij het importeren overgeslagen. De route "iedereen" is in dit geval de general route, wat betekent dat deze ophaaldag voor het betreffende afvaltype voor alle postcodes geldt.
+**LET OP: de datum notatie moet jjjj-mm-dd zijn.**
+==== Postcode data bestand ====
+De postal codes data file moet in ieder geval de volgende kolommen bevatten:
+  * "Postcode" (of Engels: "Postal code") bestaande uit 4 cijfers en 2 letters.
+  * "Huisnummer begin" (of Engels: "House number start") mag leeg zijn, of moet numeriek zijn (zonder huisnummer toevoeging)
+  * "Huisnummer einde" (of Engels: "House number end") mag leeg zijn, of moet numeriek zijn (zonder huisnummer toevoeging)
+  * "Huisletter begin" (of Engels: "House letter start") mag leeg zijn, of moet 1 letter zijn
+  * "Huisletter einde" (of Engels: "House letter end") mag leeg zijn, of moet 1 letter zijn
+  * "Even/Oneven" (of Engels: "Even/Odd") mag leeg zijn of gevuld met de waard "even" (NL/EN) of "oneven" (of Engels: "odd") om aan te geven of de routes alleen gelden voor de even of oneven nummers op deze postcode.
+  * "Container" (of Engels: "Container") geeft aan of er een algemene container aanwezig is voor deze postcode (b.v. voor een appartementencomplex).
+  * 1 of meer route kolommen, deze dienen in de titel in ieder geval het woord "route" te bevatten (zowel NL als EN). De rest van de kolom titel is vrij in te vullen. De waarden in deze kolom moeten overeen komen met de route namen die in het trash collection data file zijn opgenomen. Als de route kolom een waarde bevat die niet voor komt in de trash collection data file, dan wordt deze route genegeerd.
+Voorbeeld:\\
+{{:dvg7:functionaliteit:dvg_trash_postcode_data_voorbeeld.png?nolink&600|}}\\
+De kolommen "Plaatsnaam" en "Straatnaam" in dit voorbeeld bevatten informatie die bij de import niet wordt meegenomen. Deze kolom namen kunnen worden opgegeven als "ignore columns" (door uw leverancier in te stellen), zodat deze ook geen melding geven bij het importeren van het bestand.
+==== Voorbeeld ====
+{{:dvg7:functionaliteit:schermafbeelding_2019-06-11_om_16.06.31.png?direct&600|}}\\
+In bovenstaande bestanden kunnen we zien dat op 8 januari 2018 (groen) voor de huisnummers 28 tot en met 32 van de postcode 4927RH (groen) de route "maandag" (blauw) opgehaald wordt. In de andere tabel zien we dat die route op die datum ingevuld is voor afvaltype "GFT", "PMD" en "Kerstboom" (blauw). Dus de bewoner van postcode 4927RH nummer 30 krijgt op 8 januari in de afvalkalender te zien dat hij GFT, PMD en kerstboom aan kan bieden.
+===== Inschrijven voor ophalen =====
+Het is nu ook mogelijk om een bepaald afvaltype "op inschrijving" beschikbaar te stellen. U kan dan aangeven op welke dagen een bepaald afvaltype opgehaald wordt in uw data bestanden. Uw leverancier kan u voor een bepaald afvaltype in laten stellen dat het "op inschrijving" is.
+De gebruiker krijgt dan op de dagen dat dit afvaltype beschikbaar is een link te zien naar een webformulier dat u zelf kan beheren. U kan instellen wel formulier op de configuratiepagina: /admin/content/trash-calendar/config.
+In dit formulier kan u gebruik maken van 3 tokens om velden van standaard waardes te voorzien zoals de postcode, huisnummer en ophaaldag.
+De te gebruiken codes staan in de beschrijving op het configuratie scherm en zijn:
+[current-page:query:postal_code], [current-page:query:house_nr], [current-page:query:pickup_day].
+Zo kan u bijvoorbeeld een formuliertje maken waar de postcode, het huisnummer en de gekozen datum alvast ingevuld zijn, en waar iemand alleen nog zijn naam hoeft in te vullen. Of bijvoorbeeld een betaling vooraf moet doen. Vervolgens kan dit formulier per e-mail verzonden worden waardoor de afspraak door de verwerkende partij afgemaakt kan worden.
+U moet aan uw leverancier aangeven voor welk afvaltype aangemeld moet worden
+===== Configuratie afvaltypes =====
+Developers gebruiken de hook hook_dvg_trash_removal_types_alter() om in te stellen
+  * Welke afvaltypes gebruikt kunnen worden.
+  * Welke label de afvaltype moet hebben.\\ Het is dus mogelijk aan de achterkant verschillende types te gebruiken die voor de gebruiker hetzelfde eruit zien, zoals gft en gft_buitengebied.
+  * Welk icoon gebruikt moet worden,\\ hier kunnen dus ook nieuwe iconen toegevoegd worden.
+  * Welk afvaltype op opt-in basis opgehaald wordt.\\ (warning) Het is in theorie mogelijk meerdere opt-in afvaltypes te hebben, maar er wordt altijd hetzelfde aanmeldformulier gelinkt.
+===== Configuratie extra bericht op pagina met afvalkalender =====
+{{:dvg7:functionaliteit:dvg_trash_extra_bericht.png?nolink&400|}}\\
+Het is mogelijk een extra bericht weer te geven op de pagina met de afvalkalender. Dit bericht kan u zelf instellen op /admin/content/trash-calendar/config.\\
+{{:dvg7:functionaliteit:dvg_trash_extra_bericht_setup.png?nolink&600|}}\\
+Het wordt getoond tussen het blokje met de types die vandaag opgehaald worden en de "print"-links.
+===== Problemen bij importeren =====
+Als u tegen foutmeldingen bij het importeren aanloopt, controleer dan de bestanden in een texteditor (notepad++, textwrangler, een programma dat platte tekst bewerkt, zonder opmaak. Niet Word dus!).
+  * Heeft de datum de juiste notatie? (JJJJ-MM-DD)
+  * Wordt de komma "," als scheidingsteken gebruikt? (Bv: "2018-01-01,Maandag" is goed, "2018-01-01;Maandag" is niet goed, vervang in het document alle ";" door ",".)
+  * Sla het bestand opnieuw op met de volgende eigenschappen:
+    * Lijneinde: Windows (CRLF)
+    * Encoding: Unicode (UTF-8) (LET OP: **NIET** "UTF-8, with BOM")
+  * Zijn alle trash-types die in de uitleg onder het upload-veld genoemd worden aanwezig in het bestand?
 ===== Module =====
-dvg_trash_removal (ezCompany)
+dvg_trash_removal versie 7.x-2.x  (ezCompany)