Item Creator
The Item Creator module enables you to create item-based pages or paragraphs from frontend, based on one of your item types.
Since item types are very flexible content templates, this means that you can use the item creator for almost any scenario you can imagine, involving user input.
For instance, you can use the Item Creator module to:
- Allow users (or some user groups) to create blog posts – or newsletters
- Submit and react on contact forms of all kinds
- Enable editors to create and maintain calendar events
- Etc.
In principle, the list of things you can do with the Item Creator is limited only by your imagination – and your budget, of course, blast it.
The Item Publisher module is only a small part of working with items in Dynamicweb. You should familiarize yourself with items in general, before reading this section.
Before using the item publisher module, you need to have one or more item types created and configured. Read about item types.
Basic Concepts
In this section you will learn about:
- Adding the Item Creator module to a paragraph
- Selecting which item type to create, and where to create it
- Using the Item Creator module to submit forms
Getting started with the Item Creator
To get started with the Item Creator, add the module to a paragraph on a page. Read about adding modules to a paragraph.
From the paragraph, you have access to the module settings window (Figure 3.1).
From here, you can control the behavior of this instance of the module - or remove it altogether.
Here’s a rundown of the settings and what they do.
We strongly discourage you from creating new sites using stylesheets, Javascript, or the theme-functionality. This is old technology, and is supported for legacy reasons.
Item Creator data settings
The Item Creator data settings control how the module works with the data provided by you and by your users.
You must:
- Select a target page for the created items. Pages are created as subpages to the target page, paragraphs are created on the selected page, and item list items are created on the Page Properties > Advanced – Item lists for the selected page. This setting selectd the page with the module attached by default.
- Select a content structure for the module – i.e. decide if you want to create pages, paragraphs, or items in a named item list.
- Select the item type the module should use as a template for item creation.
- Only items which match the content structure selected are available for selection. Read about item types and content structure restrictions here.
- If your content structure is named item list, you can choose any named item list which have been added to Item lists under Page Properties for the selected target page. Read more about named item lists here.
- If your content structure is paragraph, you have the option of selecting a content placeholder, in addition to an item type. Read about content placeholders.
- Select the publish state for a newly created item – published, unpublished or hidden.
- Decide if the new item should be added first or last on creation.
Specify a confirmation page, if you want the user to be redirected to a page after an item is created. If blank, the user is returned to the current page (where the module is located)
The Item Creator templates settings
You can select or customize a template to use on the frontend (Figure 5.1).
The Create-template is placed in /Files/Templates/ItemCreator/Create/
The form save events settings
Many people use the Item Creator to work with forms – and need an easy way to send receipts and form data by email. The form save events settings (Figure 6.1) are dedicated to that scenarios.
If you want to send a receipt by mail, or send form data to someone by mail, check the form save events boxes.
This folds out the email settings (Figure 6.2), where you can customize the email behavior of the module.
You can:
- Provide a sender name and email – or use the value from one of your item fields
- Provide a recipient email – or use the value from one of your item fields
- Provide a recipient CC and BCC email – or use the value from one of your item fields
- Provide a subject – or use the value from one of your item fields
- Select a template to use when rendering the email
- Select your encoding
- Enable logging, if you want to save a mail system log and a copy of the sent email. Logs and copies can be found in the /Files/MailLog folder