What does this do?

This module allows you to quickly generate, format, style and manage front end form templates for custom ListIt2 instances.

Who should use this module?

You must have a working knowledge of ListIt2 and at least one custom ListIt2 instance.

What field types may I use?

The following ListIt2 field type definitions work with ListIt2FEEdit:

Text Input
Text Area
Checkbox
Checkbox group
Radio group
Dropdown
Multi-select
Content page
Xlink
File Upload

There is no guarantee that other field definition types will work with ListIt2FEEdit.

Tip

When a Text Input field has an alias of 'email', ListIt2FEEdit will perform an email validation check on the input.

Be aware!

This module is an alternative, not a replacement for FormBuilder with Stikki's UDT to save FormBuilder data to a ListIt2 custom instance. See FormBuilder submission to ListItExtended for details.
The default ListIt2FEEdit template does not contain any javascript. You need to code any form field validation (other than the nominated Title field and if implemented, Captcha), the jQuery UI DatePicker, WYSIWYG in a textarea, ajax form submission, etc, yourself.
Once a record is saved, the ListIt2 custom module respects the 'PostItemSave' Event. You could for example, associate a UDT with this event to send an email to the administrator notifying him/her of the newly added record.
By specifying an item_id in the module tag, you can update an existing record. It is strongly recommended that you only use this feature on FEU protected pages.
ListIt2FEEdit does not support the ListIt2 time control feature.
The File Upload feature renames the uploaded files in the format:
```
[item_id]-[fielddef_id]-[file-name-munged-to-url].[extn]
```

How do I use it?

Simply put the following tag in your page or template:

    {ListIt2FEEdit mod='ListIt2MyCustomModule'}

This outputs the default ListIt2FEEdit template on the front end. To create your own templates, in Admin, go to Layout->ListIt2 Front End Edit, add a new tempate and code away.

To edit an existing record, create a detail template, eg 'feedit' in your custom ListIt2 instance and enter the following tag:

    {ListIt2FEEdit mod=$mod->GetName() item_id=$item->item_id}

Then on your content page, call the custom ListIt2 instance and set the detailtemplate to 'feedit'.

To create a Delete link for an existing record, create a detail template in your custom ListIt2 instance and enter the following tag:

    {ListIt2FEEdit action=delete mod=$mod->GetName() item_id=$item->item_id returnpage=$page_alias}

Then on your content page, call the custom ListIt2 instance and set the detailtemplate.

Support

This module does not include commercial support. However, there are a number of resources available to help you with it:

For the latest version of this module, FAQs, or to file a Bug Report or buy commercial support, please visit the cms development forge at dev.cmsmadesimple.org.
Additional discussion of this module may also be found in the CMS Made Simple Forums.
The author(s), Clip Magic can sometimes be found in the CMS IRC Channel.
Lastly, you may have some success emailing the author(s) directly.

As per the GPL, this software is provided as-is. Please read the text of the license for the full disclaimer.

Copyright and License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

However, as a special exception to the GPL, this software is distributed as an addon module to CMS Made Simple. You may not use this software in any Non GPL version of CMS Made simple, or in any version of CMS Made simple that does not indicate clearly and obviously in its admin section that the site was built with CMS Made simple.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Or read it online