Diese Hilfedatei auf Deutsch: hier klicken

Advanced Form plugin

Contents

  • Introduction
  • Quick install & go!
  • Installation
  • Configuration settings
  • Language settings
  • Form settings
  • Create a form
  • Modify a form
  • Delete a form
  • Integration into a CMSimple page
  • Credits
  • Other plugins
  •  

    Introduction

    The advanced form plugin is used to create mail forms, which can be integrated into any CMSimple page by means of the CMSimple scripting command. I developed this plugin because I noticed in the forum posts, that there were quite a lot of request for an easy to implement mail form. I had previously altered Peter Harteg's inbuilt mail form. Disclaimer : No warranties whatsoever, use at your own risk !

    Requirements : The CMSimple plugin loader must be installed and operational !


    Quick install & go!

    #cmsimple $output=showadvform('Default Form');#

    Back to contents

    Installation instructions

    The Advanced Form plugin is installed now

    Before you can use the Advanced Form plugin, it's necessary to

    Back to contents

    Configuration settings

    The configuration settings of the Advanced Form plugin are integrated into the CMSimple administrative module. So, first login into this module.

    Select AdvancedForm from the list of available plugins.

    Select Configuration settings from the dropdown list.

    Back to contents

    Language settings

    The language settings of the Advanced Form plugin are integrated into the CMSimple administrative module.
    So, first login into this module.

    Select AdvancedForm from the list of available plugins.

    Select Language settings from the dropdown list.

    Change the language settings according to your needs and use the save button to save the modifications you make.

    By default, the Advanced Form plugin automatically selects the language file according your CMSimple selected language settings. Example: when your CMSimple default language is set to German, the Advanced Form plugin language will also use the German plugin language file. If your CMSimple selected language file isn't available for the plugin, then the english language file is used. (If you want to add a new language file, please just copy then en.php language file located in the language folder of the advancedform plugin, rename the file xx.php where xx represents your desired language.

    Once the new xx.php language file is available, you can start translating the plugin language settings as described in the
    procedure above.

    Back to contents

    Form settings

    The form settings of the Advanced Form plugin are now found in the CMSimple settings module.
    So, first login into this module.

    Select AdvancedForm from the list of available plugins.

    Select Form settings from the dropdown list.

    Create a form

    when entering (clicking ) the properties field, you can define fieldtype specific properties.

    press the Save button

    decide if the field must be filled by checking the required box

    Currently, the following field types are supported:

    Field type properties

    Size: in characters

    Maxlength: in characters

    Value: text you want to appear in the object

    Options: list of entered values

    Up: move the selected value up

    Down: move the selected value down

    Delete: delete the selected value(s)

    Cols: number of columns of the textbox

    Rows: number of rows of the textbox

    Wrap: text wrapping within the textarea

    • Hard
    • Soft
    • Off

    Back to contents

    Modify a form

    Back to contents

    Delete a form

    Back to contents

    Integration into a CMSimple page

    Create a form on a CMSimple page

    The advanced forms are called by means of a special function named : showadvform().
    This function has only one required parameter:

    If you want to use one of your defined form(s) on a CMSimple page, please follow the steps listed below:

    Back to contents


    Create a link to the page containing a form (optional)

    The link to your form page is called by means of a special function called showadvformlink().
    This is useful in creating a link on the template, or for calling the form by means of CMSimple Scripting. This function has two parameters:

    To display a (hyper)link to the page containing your form within your template., please follow the steps listed below:

    Back to contents

    Credits

    Beta Testing
    I'd like to thank the following persons who spend some of their free evenings by testing this plugin:
    Translators
    Others

    Some idea's found in several different formmailer and samples of form generator php scripts from various resources on the internet.

    Back to contents

    Other available plugins

    Please visit the sites listed below to download other available plugins for CMSimple:

    Back to contents