# README

![](/files/6SudlvTfSVw5WaQA5Mwl)

**Module xForms**

## for XOOPS 2.5.10+

## for PHP 7.2+

![](/files/mZiKZmjZC5V5wGwzKRT0)

**User Manual**

© 2021 XOOPS Project ([www.xoops.org](https://xoops.org))

**Module Purpose**

xForms is a module for XOOPS to offer widely customizable web forms.

This module allows the generation of different kinds of form elements e.g. text areas, check boxes for webmasters to create their "Contact Us" forms. Submitted information can be sent by email or through the private message system of XOOPS, and received by selected user group(s).

**Some of the functions include:**

* Ability to record data in the database.
* Sending email (copied configurable) and private message
* Management of attached files and images (including downloaded)
* Multiple configurations form (descriptions, shipping methods, etc.).
* Generation of reports for saved forms
* Set start and end dates of validity

![](/files/tdi1WBCJW9xKw5nHTOuy)

*Figure 1: Main view of the xForms Module (Admin side)*

**Download/Fork the Module** ![](https://xoops.org/images/forkit.png)

**You can fork the module -->** [**here**](https://github.com/XoopsModules25x/xforms)**)**

**How to Contribute**

[You can contribute on GitHub](https://github.com/XoopsDocs/xforms-tutorial). Changes will be [pushed to Gitbook.io automatically](https://xoops.gitbook.io/xforms-tutorial/activity) when the [main repository](https://github.com/XoopsDocs/xforms-tutorial) changes.

Editing the book can be done either by updating the markdown files with a text editor, or opening the repository in [the Gitbook desktop app](https://github.com/GitbookIO/editor/blob/master/README.md). The desktop app will give you a live preview option.

**Table of Content**

* [Install/Uninstall](/xforms-tutorial/1install.md)
* [Administration Menu](/xforms-tutorial/2administration.md)
* [Preferences](/xforms-tutorial/3preferences.md)
* [Operating Instructions](/xforms-tutorial/4operations.md)
* [The User Side](/xforms-tutorial/5userside.md)
* [Blocks](/xforms-tutorial/6blocks.md)
* [Templates](/xforms-tutorial/7templates.md)
* [Miscellaneous](/xforms-tutorial/8other.md)
* [Module Credits](/xforms-tutorial/9credits.md)
* [About XOOPS CMS](/xforms-tutorial/10aboutxoops.md)

**License:**

[![Creative Commons License](https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png)](http://creativecommons.org/licenses/by-nc-sa/4.0/)\
Unless specified, this content is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](http://creativecommons.org/licenses/by-nc-sa/4.0/).

All derivative works are to be attributed to XOOPS Project ([www.xoops.org](https://xoops.org))


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://xoops.gitbook.io/xforms-tutorial/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.