Urdu English
English English Deutsch Deutsch Español Español Français Français Italiano Italiano Nederlands Nederlands Português Português Русский Русский Ελληνικά Ελληνικά

Welcome to Jumi! >> Tutorial >> Iframed Formmail handler with Jumi

Let us assume you need to create a form on your website which passes the required information by e-mail and publish it in a module position and/or in a content item.

HiQ Formmail is a php form handler. Features: Multiple attachments, Limit types of attachments allowed, Block attachments by extension, Multiple recipients and Bcc(s), Auto responder, Custom header/footers for output, redirect and more. It works with safe mode on and register_globals off.

HiQMF is not a Joomla! component - it is a standalone application. This approach has some advantages: your Joomla! configurations and database remain intact.

In this tutorial I will show you how to make HiQMF the integral part of your Joomla! website, namely how to publish forms in a module position and/or in an content item.


  1. server running PHP 4.1 at the least,
  2. Joomla,
  3. Jumi module and/or plugin,
  4. HiQ Formmail v. 2.0 that can be downloaded here,
  5. some knowledge of html and forms.

HiQMF installation and configuration

  1. Download HiQ Formmail from the developer's web pages.
  2. Follow HiQMF documentation - just extract the content into the new folder (preferably with the name hiqmf) under you Joomla root. In the following I will suppose your new folder hiqmf is directly under your root: your_joomla_root/hiqmf.
  3. Follow documentation and edit the configuration file HiQFMConfg.conf using your favorite text editor.
  4. Run included test.html form i.e. write in the address line of your browser:

For the security purpose I do recommend:

  • place into each directory you create empty index.html file,
  • include in your robots.txt file line
    Disallow: /hiqmf/
These measures will prevent you directories from other eyes searching.

Jumi - HiQMF - Joomla integration

I will show you the whole process on the real example that can be downloaded here. You can later customize various css, js and other files to conform your website visibility standards.

  1. Create form and place it in your "hiqmf" directory on the web. Be aware of the dimensions of the form because it must fit into you module dimensions.
    For our learning purpose I created simple form example.html with e-mail verification. It is included in the demo packet.
    Study it and play with it. You will notice example.html contains reference to
    - example.css file (css template of the forms),
    - check.js (javascript that verifies sender's e/mail address),
    - footer.js (some standardized javascript footer of the form) and
    - thanks.html (just thank you page).
    Place all of these files in "incl" directory under your "hiqmf" directory.
  2. Test it in your browser: http://www.yourwebsite.com/hiqmf/example.html.
  3. In order to integrate the form into Joomla! module or content item I prepared jumi_forms.php file. The code is very simple: it just includes HiQMF forms into the appropriate position via the well know html tag iframe. You can modify it as you want of course. Place jumi_forms.php into your hiqmf folder.

I am repeating the whole directory structure here:

  • Joomla root
    • administrator
    • cache
    • components
    • ...
    • ...
    • hiqmf (contains HiQMF native files: HiQMF.php, HiQMFConf.conf, etc and your forms example.html, jumi_forms.php)
      • incl (contains custom css, js or other files E.g.: example.css, check.js, thanks.html)
      • TEMP_FILES (temporary HiQMF files)
    • images
    • includes
    • languages
    • ...
    • ...
  1. Now decide weather you wish to place the form into a module position or a content item. Use Jumi module or Jumi plugin for the purpose respectively and from Jumi component include hiqmf/jumi_forms.php by this way:





[form file name] [width] [height] [scrolling]


{jumi [hiqmf/jumi_forms.php] [form file name] [width] [height] [scrolling]}


  • width is the width of the form in percents or pixels,
  • height is the height of the form in pixels,
  • scrolling is the scroll bars visibility: yes/no/auto.

That means our concrete plugin demo code will be:

{jumi incl[hiqmf/jumi_forms.php] form[hiqmf/example.html]
width[180px] high[430] scroll[no]}

Anything out of the [] brackets are remarks that Jumi ignores. You can use them and you do not need to use them.

  1. Publish a module or save an article with the Jumi plugin reference.


You can make use of the standard Joomla! component wrapper for displaying your form too. The result will be show in a wrapper component (like an individual article).

All you need in the future is to develop your own html forms. All other files like css, js, "thank you" files can be made quite universal. You can even customize jumi_forms.php to your specific needs.

Furthermore you may wish to customize the various HiQMF header and footer files to match in with the rest of your website: er_header_def.htm, er_footer_def.htm, header_def.htm, footer_def.htm.

You can also utilize all of the standard html forms features and specialties of HiQ Formmail handler too (like attachments, autoresponder, ...).