Installing Formalicious requires the free Extra FormIt 4.1.1-pl to function properly. FormIt is also maintained by us and thus, should guarantee maximum compatibility between FormIt and Formalicious. The MODX installer should install this automatically when installing Formalicious from the modmore repository.
A custom manager page called Formalicious is installed within the Extras menu. Also a Template Variable and Element Category named Formalicious are created. The Template Variable should be assigned to all the templates you wish to use Formalicious forms on and a Snippet should be added to those templates. Access to Formalicious and the admin panel can be set at the modx ACL access policies.
To accomplish this, follow these steps:
- Click the formalicious TV
- Click Template Access
- Enable the checkmarks for the templates on which you want to use Formalicious-forms
- Save your changes
- Go to every template you just enabled
- In the field Template code (HTML), add the following Snippet-call at the location where you want to show your forms:
[[!FormaliciousRenderForm? &form=`[[*formalicious]]`]]We recommend to add it just below the
[[*content]]placeholder, because it enables your content-managers to add text above the form.
- An alternative would be to create a chunk called form where you add the above Snippet-call. Instruct your content-managers to add the chunk-code
[[$form]]anywhere they want, so they have more flexibility regarding the location of their forms, e.g. in-between two paragraphs.
- Save your changes
Inserting a form with ContentBlocks
If you also use ContentBlocks, you can use a field to select a form to insert as well, instead of needing the template variable and form code in your template. This gives your content editors more control over what form is inserted at what position.
Formalicious will add its custom input type during installation. At Extras > ContentBlocks, create a new field using the "Formalicious Form Selector" input type and customise the template as needed.