Relatieve datumfilters

Wat is dit?

In KampAdmin kun je datumfilters gebruiken met Nederlandse trefwoorden en relatieve uitdrukkingen in plaats van altijd handmatig datums in te voeren. Dit werkt voor alle datum- en datumtijdfilters (=, >, <, >=, <=) maar nog niet voor het "tussen" filter.

Hoe werkt het?

Je selecteert eerst een datum via de datumkiezer, vervangt dan het datumveld in de URL door een Nederlands trefwoord of relatieve uitdrukking:

Nederlandse trefwoorden

Deze trefwoorden worden automatisch omgezet naar de juiste datum:

Relatieve uitdrukkingen

Voor nog meer flexibiliteit kun je relatieve uitdrukkingen gebruiken:

Basis relatieve uitdrukkingen

• 14d = 14 dagen in de toekomst
• -7d = 7 dagen in het verleden
• 2w = 2 weken in de toekomst
• -1w = 1 week in het verleden
• 3m = 3 maanden in de toekomst
• -6m = 6 maanden in het verleden
• 1y = 1 jaar in de toekomst
• -2y = 2 jaar in het verleden

Grensgebaseerde uitdrukkingen

• 0wr = Begin van deze week
• -1wr = Begin van vorige week
• 1wr = Begin van volgende week
• 0mr = Begin van deze maand
• -1mr = Begin van vorige maand
• 1mr = Begin van volgende maand
• 0yr = Begin van dit jaar
• -1yr = Begin van vorig jaar
• 1yr = Begin van volgend jaar

Praktische voorbeelden

Voorbeeld 1: Alle inschrijvingen van vandaag

people?filters[created_at][gte][]=vandaag

Voorbeeld 2: Personen geboren in de afgelopen 18 jaar

people?filters[birthdate][gte][]=-18y

Voorbeeld 3: Activiteiten die starten vanaf volgende week

activities?filters[start_date][gte][]=1w

Voorbeeld 4: Betalingen van deze maand

payments?filters[created_at][gte][]=start_maand&filters[created_at][lte][]=einde_maand

Voorbeeld 5: Monitoren die solliciteerden sinds begin van het schooljaar

monitors?filters[applied_at][gte][]=start_schooljaar

Voorbeeld 6: Inschrijvingen van de afgelopen 30 dagen

subscriptions?filters[created_at][gte][]=-30d

Voorbeeld 7: Activiteiten die eindigen voor het einde van het jaar

activities?filters[end_date][lt][]=einde_jaar

Voorbeeld 8: Personen die zich inschreven tussen vorige week en volgende week

people?filters[created_at][gte][]=-1w&filters[created_at][lte][]=1w

Hoe gebruik je dit?

1. Ga naar de gewenste lijst (personen, activiteiten, betalingen, etc.)
2. Pas een datumfilter toe via de normale interface
3. Kopieer de URL uit je browser
4. Vervang de datum door een Nederlands trefwoord of relatieve uitdrukking
5. Herlaad de pagina of plak de URL in een nieuwe tab

Handige combinaties

Voor seizoensgebonden activiteiten

# Zomerkampen van dit jaar
activities?filters[start_date][gte][]=start_jaar&filters[end_date][lte][]=einde_jaar

# Activiteiten van het huidige schooljaar
activities?filters[start_date][gte][]=start_schooljaar&filters[end_date][lte][]=einde_schooljaar

Voor administratieve taken

# Nieuwe inschrijvingen van deze week
subscriptions?filters[created_at][gte][]=start_week

# Betalingen die nog niet zijn verwerkt (ouder dan 7 dagen)
payments?filters[created_at][lt][]=-7d&filters[status][]=pending

Voor planning en monitoring

# Monitoren die binnen 2 weken moeten beginnen
monitors?filters[start_date][gte][]=vandaag&filters[start_date][lte][]=2w

# Activiteiten die binnen een maand starten
activities?filters[start_date][gte][]=vandaag&filters[start_date][lte][]=1m

Let op!

• Geen "tussen" filter: Deze functie werkt nog niet met het "tussen" filter. Gebruik twee aparte filters (>= en <=) in plaats daarvan.
• URL-aanpassing: Je moet de URL handmatig aanpassen na het selecteren van een datum via de normale interface.
• Datumformaat: Alle datums worden automatisch omgezet naar het juiste formaat (YYYY-MM-DD).
• Schooljaar logica: Het schooljaar loopt van 1 september tot 31 augustus van het volgende jaar.

Nog vragen?

Loop je tegen iets aan of heb je een geweldig idee voor nieuwe trefwoorden? Laat het ons weten! We denken graag met je mee en zorgen ervoor dat KampAdmin precies doet wat jij nodig hebt.