Skip to content

Latest commit

 

History

History
42 lines (22 loc) · 3.16 KB

README.md

File metadata and controls

42 lines (22 loc) · 3.16 KB

Gravity Forms Pages

List and display Gravity Forms forms without shortcodes

Description

This WordPress plugin requires at least WordPress 4.4 and Gravity Forms 2.0.

Do you find yourself regularly creating pages just to paste in a Gravity Forms shortcode and hit publish? Having too many pages in your site installation just to present a different form in each one of them? This plugin removes that trouble at once by generating urls for your forms as well as a form archive to browse through your forms.

A form archive page is generated which lists the available forms on your site. Additionally each form gets a unique url to navigate to, where the form is presented as if it were its own page. There's no need for shortcodes anymore when you just want to present a form in its own right.

Availability of forms as pages can be set globally and on a per-form basis. When made available, form settings like inactive status, required user login and time schedule restrictions are respected before the form is displayed.

When desired, you can disable the form archive listing in the plugin's settings. Customize plugin settings in the "Pages" tab in Gravity Forms's Settings admin page.

Developers can modify the availability of a form through the gf_pages_hide_form filter.

Theme Compatibility

By default, the plugin generates the pages of both the form archive and single forms using template files from your theme. This theme-compat logic is similar to the ones featured in plugins like bbPress and BuddyPress. If your theme contains a single.php or page.php template file, this plugin will handle the content insertion automagically. See gf_pages_get_theme_compat_template() for the full stack of queried template files.

When desired, the templates used for displaying both the form archive and single forms can be overridden in your theme. Use the following file names in your theme's gravityforms template folder:

  • archive-gf-pages-form.php for the form archive page. See gf_pages_get_form_archive_template() for all options.
  • single-gf-pages-form.php for a single form page. See gf_pages_get_form_template() for all options.

Refer to the includes/form.php file for the form archive and single form template tags. See the templates/default/gravityforms/content-archive-form.php template part for an example of how to structure the form archive's content.

Installation

If you download Gravity Forms Pages manually, make sure it is uploaded to "/wp-content/plugins/gravityforms-pages/".

Activate Gravity Forms Pages in the "Plugins" admin panel using the "Activate" link. Plugin settings are located in the "Pages" tab in Gravity Forms's Settings admin page.

Updates

This plugin is not hosted in the official WordPress repository. Instead, updating is supported through use of the GitHub Updater plugin by @afragen and friends.

Contributing

You can contribute to the development of this plugin by opening a new issue to report a bug or request a feature in the plugin's GitHub repository.