Skip to content

Settings

Mike van den Hoek edited this page Nov 3, 2026 · 3 revisions

Settings

All settings are available under Settings > OWC | GravityForms ZGW instellingen in the WordPress admin. By default, only administrators can see or edit them.

Transactie overzicht (Transaction overview)

Every form submission that's connected to a ZGW "zaaksysteem" is logged as a transaction, viewable under Transacties in the WordPress admin.

  • Gebruikersrollen — Selects which user roles, besides administrators, are allowed to view the transactions overview.

Transactie rapport (Transaction report)

  • Verzenden naar — The email address that receives a daily report of failed transactions. The report is sent once a day via WP-Cron and only lists transactions that failed, so it can be left empty if no one needs to be notified.

Vertraging na zaakcreatie (Delay after zaak creation)

Some ZGW suppliers need a moment after a zaak is created before its related resources (e.g. documents) can reliably be attached. This setting adds a configurable delay after zaak creation for the selected supplier(s).

  • Vertraging na zaakcreatie (seconden) — The delay in seconds (0–10) to wait after a zaak has been created.
  • Pas vertraging toe op leverancier(s) — The supplier(s) the delay should apply to. Suppliers not selected here create zaken without any added delay.

Client request timeout

  • Request timeout (seconden) — A custom request timeout in seconds (15–60) for the ZGW API client, used instead of the client's default timeout.
  • Pas aangepaste timeout toe op leverancier(s) — The supplier(s) the custom timeout should apply to. Useful for suppliers whose API is known to respond slowly.

Bestandsnamen van uploads (Upload file names)

By default, an uploaded file is stored in the zaaksysteem under its original file name, prefixed with a unique ID (e.g. 6721f0a3b1c2d_paspoort.pdf). This setting names each upload after its document type ("informatieobjecttype") instead, so files in the zaak are named consistently.

  • Documenttype als bestandsnaam — When enabled, each upload is named after the description ("omschrijving") of its linked document type, e.g. bijlage.pdf.
    • When a form contains multiple uploads with the same document type, a sequence number is added, e.g. bijlage_1.pdf and bijlage_2.pdf.
    • The original file name is stored as the document's description ("beschrijving"), so the zaak still shows which file was uploaded, unless the upload field has its own description configured. Percent-encoded characters (e.g. %20) are decoded, and the invisible soft hyphens macOS adds to Dutch screenshot names ("Schermafbeelding") are removed.
    • The document type name is taken from the cached zaaktypen and informatieobjecttypen (see below). The ZGW API is only called when the cache doesn't have it. If the name still can't be retrieved, the original file name is used.

Zaaktypen en informatieobjecttypen cache (Zaaktypen and informatieobjecttypen cache)

The zaaktypen and informatieobjecttypen shown in a form's "Zaaksysteem" settings tab are fetched from the configured ZGW supplier(s) and cached for 24 hours, so opening the form settings doesn't have to wait on the ZGW API.

  • A WP-Cron job runs daily at 04:00 to refresh the cache before anyone needs it.

  • Use the Zaaktypen en informatieobjecttypen opnieuw ophalen button on the settings page to clear the cache manually, forcing a fresh fetch on next use.

  • By default, only administrators (manage_options) can see and use this button. Filter owcgfzgw::form_settings/cache_capability to additionally expose it to users with a different capability — those users only see this cache section, not the rest of the settings page:

    add_filter( 'owcgfzgw::form_settings/cache_capability', function ( string $capability ): string {
        return 'my_custom_capability';
    } );

Clone this wiki locally