Documentation - Ask Info Popup

Installation and Basic Setup

1 – How to install Ask Info Popup

You can easily install Ask Info Popup using the standard plugin installation process. You have to click on “Extensions->Extension Manager” then you have to select the .zip file you have downloaded from our site and just click “Install”. By default, the plugin is disabled, so you have to active it by clicking on "Extensions->Plugin Manager" and then on "System - Ask Info Popup", just change "Disabled" to "Enabled".

2 – Plugin Usage

For each button you can choose to use the default plugin settings or to override them by specifying some parameters in the tag declaration.

Here is the list of the parameters that can be overwritten:

  • template - Possible values: a filename placed in 'media/plg_system_askinfopopup'
  • layout - Possible values: popup, slider
  • buttonText - Possible values: any string is allowed.
  • showName - Possible values: 2,1,0. (2 = Required, 1 = Show, 0 = Hide)
  • showMail - Possible values: 2,1,0. (2 = Required, 1 = Show, 0 = Hide)
  • showMessage - Possible values: 2,1,0. (2 = Required, 1 = Show, 0 = Hide)
  • recaptcha - Possible values: 1,0. (1 = Yes, 0 = No)
  • recipient - Possible values: This email address is being protected from spambots. You need JavaScript enabled to view it.,This email address is being protected from spambots. You need JavaScript enabled to view it.,This email address is being protected from spambots. You need JavaScript enabled to view it.,etc.
  • emailSubject - Possible values: any string is allowed.
  • sendCopy - Possible values: 1,0. (1 = Yes, 0 = No)

At this page you can find some examples, i will repeat here the same structure with the tags that we have used to create those forms. Also, this is a screenshot with the plugin's settings that we have used, so that you can see how the overriding method works.

Popup Layout

Basic Template

{{ask_info_popup}}

Custom Template

{{ask_info_popup template=custom}}

Custom Template with reCaptcha

{{ask_info_popup template=custom|recaptcha=1}}

Slider Layout

Basic Template

{{ask_info_popup layout=slider}}

Custom Template

{{ask_info_popup layout=slider|template=custom}}

Custom Template with reCaptcha

{{ask_info_popup layout=slider|template=custom|recaptcha=1}}

As you can see you can override multiple parameters at once by simply separating them with a "|"(pipe). Let's have a look at the last example, Slider Layout - Custom Template with reCaptcha. With those parameters we have changed the default layout configured in back end (popup), with the slider, and we have also enabled reCaptcha that by default is disabled. In this example we have also used a custom template, this template is included by default in the extension and it is declared in the file "media/plg_system_askinfopopup/custom.xml".

2 – Custom Templates

You can easily use custom templates by simply adding the "template" parameter when declaring the plugin tag. The value of this parameter should be the name of an xml file that should be placed under the path "media/plg_system_askinfopopup". By default you will find a file called "custom.xml" in that path, this is an example of custom template. You can try it by simply adding a tag like this {{ask_info_popup template=custom}}. In this file you can find all the possible field types (list, text, mail, textarea).

This should give you the instruments to customize the form to be able to fit your needs. If there is something not clear, do not hesitate to contact our support team from our contact form.