Cookbook @ Zotonic

Cookbook

Add a contact form

Choose a survey form or implement a validated server-side mail handler.

Cookbook

Add a custom content block

Add a plain-text callout block using current admin field names.

Cookbook

Add a field to the resource editor

Use an admin widget and the existing resource form.

Cookbook

Add a filter or rendering component

Use a filter for a small transformation of an input value. Keep missing and unexpected values predictable, and escape output at the point where it becomes HTML.

Cookbook

Add a named resource search

Use a current search notification and let Zotonic apply resource visibility.

Cookbook

Add an HTTP controller

Use controller_template when a dispatch rule only needs to render a template. Write a custom controller when the endpoint needs additional request processing or response behavior.

Cookbook

Add an icon to a control

Use icons from the loaded theme and keep the control accessible.

Cookbook

Add a stylesheet to admin

Use a small active module or site template override.

Cookbook

Add a supervised Erlang worker

Add a gen_server and verify that its supervisor restarts it.

Cookbook

Adjust the resource editor layout

Override the smallest category-specific admin component.

Cookbook

Admin template specific things

Common markup in admin templates.

Cookbook

Assign a user group from a trusted creation workflow

Add membership after creation with explicit permissions.

Cookbook

Choose a destination after signup

Return a fixed local destination from the current signup notification.

Cookbook

Complete module and function names in the shell

Use shell completion without relying on a particular startup mode.

Cookbook

Create a custom template tag

Render escaped text through the current zotonic_scomp behaviour.

Cookbook

Create an Erlang application with Rebar3

Build a small standalone OTP application using Erlang/OTP 28 and Rebar3.

Cookbook

Create a public site-map page

Render the navigation menu on a named page.

Cookbook

Create a reusable browser action

Wrap a maintained Zotonic action instead of assembling JavaScript strings.

Cookbook

Create a reusable module

Create apps_user/zotonic_mod_garden with the following files. This example adds a discoverable module without starting an extra process.

Cookbook

Customize HTTP error pages

Override the error template while preserving the response status.

Cookbook

Customize login and signup presentation

Reuse the maintained authentication flow and override its presentation.

Cookbook

Enable a module from the Erlang shell

Enable an installed module on one site and verify the result.

Cookbook

Expose data through a model

Create src/models/m_garden.erl in the Garden module. This complete example exposes a public greeting:

Cookbook

Index a custom resource property

Create a pivot column and fill it through the custom_pivot notification.

Cookbook

Inspect and export Zotonic metrics

Discover actual metrics before configuring subscriptions.

Cookbook

Normalize and filter Unicode text

Keep UTF-8 characters intact while transforming user text.

Cookbook

Override a module template

Find the active template and its path relative to priv/templates. Create the same relative path in your site or another active module with a higher selection priority.

Cookbook