Snippets
To customize a snippet, add your version under the directory site/snippets/email-manager. For example, if you want to modify the form rendering, create a new snippet file in the directory with the same name as the original. The Email Manager will automatically use your custom snippet instead of the default one.
The default snippets are designed to handle most email form use cases. Customize them only if necessary, and test thoroughly to avoid unexpected issues.
$field
Additionally, $field provides access to several useful helper functions to streamline customization.
Helper
# String with all attributes for the input element
$field->attr(): string
# Access the field value
$field->value()Attribute
# get the field type
$field->type(): string
# get the class
$field->class(): string
# get the placeholder text
$field->placeholder(): ?string
# get the requiered status
$field->required(): bool ?? false
# get the aria label
$field->ariaLabel(): ?string
# get the field options
$field->options(): ?arraySnippets
The following snippets are fully customizable and can be overwritten by adding a file with the same name in the site/snippets/email-manager directory. This flexibility allows you to adapt the default functionality and appearance to better suit your project’s requirements.
fields/checkbox.php
This snippet renders checkbox groups for forms, allowing users to select multiple options.
fields/date-range.php
This snippet renders a date-range fields, allowing users to select a start and end date.
fields/date.php
This snippet renders a date picker for forms, enabling users to select a specific date for appointments or deadlines.
fields/email.php
This snippet renders an email input field for forms, allowing users to provide their email address for communication purposes.
fields/file.php
This snippet renders a file upload field for forms, enabling users to attach files such as resumes, images, or documents.
fields/number.php
This snippet renders a numeric input field for forms, allowing users to enter numerical data such as quantities or IDs.
fields/radio.php
This snippet renders a group of radio buttons for forms, enabling users to select one option from a predefined set.
fields/select.php
This snippet renders a dropdown menu for forms, allowing users to choose a single option from a list.
fields/tel.php
This snippet renders a telephone input field for forms, enabling users to provide their phone number for contact purposes.
fields/text.php
This snippet renders a single-line text input field for forms, allowing users to enter brief information such as names or titles.
fields/textarea.php
This snippet renders a multi-line text area for forms, enabling users to input longer messages or comments.
fields/time.php
This snippet renders a time picker for forms, allowing users to select a specific time for meetings or appointments.
fields/url.php
This snippet renders a URL input field for forms, enabling users to provide a website link or other online resource.
After customizing a snippet, test its functionality thoroughly:
- Check that the snippet is loaded correctly in the frontend.
- Verify that all expected form behaviors are maintained, such as field validation and email submission.
- Ensure that the visual appearance aligns with your design expectations.
Testing ensures your customizations are reliable and meet the needs of your project.