{"id":45128,"date":"2009-09-29T17:01:19","date_gmt":"2009-09-29T17:01:19","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/forms\/"},"modified":"2010-04-01T23:17:29","modified_gmt":"2010-04-01T23:17:29","slug":"forms","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/forms\/","author":186678,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.4 (beta11)","stable_tag":"trunk","tested":"2.9.2","requires":"2.7","requires_php":"","requires_plugins":"","header_name":"Forms","header_author":"Weston Ruter","header_description":"","assets_banners_color":"","last_updated":"2010-04-01 23:17:29","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"http:\/\/wordpress.org\/extend\/plugins\/forms\/","header_author_uri":"http:\/\/weston.ruter.net\/","rating":0,"author_block_rating":0,"active_installs":100,"downloads":10453,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.9"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[601,2906,724,2490],"plugin_category":[42],"plugin_contributors":[78438],"plugin_business_model":[],"class_list":["post-45128","plugin","type-plugin","status-closed","hentry","plugin_tags-forms","plugin_tags-input","plugin_tags-validation","plugin_tags-web-forms","plugin_category-contact-forms","plugin_contributors-westonruter","plugin_committers-westonruter"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/forms.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n

This plugin is developed at\nShepherd Interactive<\/a>\nfor the benefit of the community. No support is available. Please post any questions to the support forum<\/a>.<\/em><\/p>\n\n

Allows forms to be written with new HTML5 input type and validation attributes, and\nthen to have them validate themselves server-side: DRY forms (don't repeat yourself).\nForms are embedded into posts via the form<\/code> shortcode. Results can be automatically emailed.\nA web form is defined in a PHP function that returns an entire form element, for example:<\/p>\n\n

function my_contact_form($attrs, $content = null){\n    ob_start();\n    ?>\n    <form method=\"post\">\n        <p hidden=\"hidden\" class=\"form_error_message\"><\/p>\n        <p>Name: <input type=\"text\" required=\"required\" name=\"contact_name\" maxlength=\"255\" placeholder=\"Jo Smith\" autofocus=\"autofocus\" \/><\/p>\n        <p>Email: <input type=\"email\" required=\"required\" name=\"contact_email\" maxlength=\"255\" placeholder=\"jsmith@example.com\" \/><\/p>\n        <p>Message: <textarea required=\"required\" name=\"contact_message\" maxlength=\"1000\" placeholder=\"Enter your message here\"><\/textarea><\/p>\n        <p><button type=\"submit\">Submit<\/button><\/p>\n    <\/form>\n    <?php\n    $ret = ob_get_contents();\n    ob_end_clean();\n    return $ret;\n}\n<\/code><\/pre>\n\n
And this form can be embedded into a post by entering [form name=\"my_contact_form\"]<\/code>.\nHere are the shortcode options:<\/p>\n\n
    \n
  • name<\/code><\/li>\n
  • email_to<\/code><\/li>\n
  • email_cc<\/code><\/li>\n
  • email_bcc<\/code><\/li>\n
  • email_subject<\/code><\/li>\n
  • success_url<\/code><\/li>\n
  • success_page_id<\/code><\/li>\n
  • cc_sender<\/code> default: false<\/code><\/li>\n
  • email_type<\/code> default: (HTML) table<\/code>: other options dl<\/code>, text<\/code>, form<\/code><\/li>\n<\/ul>\n\n
    These options may also be specified via Custom Fields (postmeta):<\/p>\n\n
      \n
    • form_name<\/code><\/li>\n
    • form_email_to<\/code><\/li>\n
    • form_email_cc<\/code><\/li>\n
    • form_email_bcc<\/code><\/li>\n
    • form_email_subject<\/code><\/li>\n
    • form_success_page_id<\/code><\/li>\n
    • form_success_url<\/code><\/li>\n
    • form_email_type<\/code><\/li>\n<\/ul>\n\n
      Many filters and actions are available. Please see the source code.<\/p>\n\n
      When the form is submitted and the server determines that user data is invalid, then the server will respond with 400 Invalid Request.\nIn the 400 response, the page containing the form is returned and the form repopulated with the user's original request with\nclass names and data-<\/code> attributes that describe the errors on an invalid element.<\/p>\n\n
      If the server successfully validates the form, then the user will be redirected to success_url<\/code> or success_page_id<\/code> if they are provided.<\/p>\n\n
      Please see source code for full documentation.<\/p>\n\n
      Handling File Inputs<\/h4>\n\n
      Files are uploaded to \/wp-content\/uploads\/<\/code> (or whatever this is specified to\nbe in your install), unless filtered to be something different via\n    form_file_upload_path filter, or if the data-upload-path<\/code> attribute is set on\nthe file input<\/code> element, for example:<\/p>\n\n
      <input type=\"file\" data-upload-path=\"<?php\n        $uploadDir = wp_upload_dir();\n        echo esc_attr(parse_url(trailingslashit($uploadDir['baseurl']) . 'form-submissions\/', PHP_URL_PATH));\n?>\" name=\"my_image\" pattern=\".+\\.(jpe?g|gif|png)\" \/>\n<\/code><\/pre>\n\n
      The upload path is appended to the ABSPATH<\/code>,\nand it must be within the \/wp-content\/uploads\/<\/code> directory (or\nequivalent) or a security exception will be raised. When the server fails to\nmove the file or if it is too big or if some other error occurs (e.g. directory\nnot writable), then the form submission will respond with a 500 error and the\nfile control will be marked as invalid customError<\/code> and the specific\nerror will be included on the data-validationMessage<\/code> attribute.<\/p>\n\n\n
      2010-04-01: 0.4 (beta11)<\/h4>\n\n
        \n
      • Adding form_abort_on_email_failure<\/code> filter so that emails don't have to abort success<\/li>\n
      • Added form_complete<\/code> and form_error<\/code> actions.<\/li>\n<\/ul>\n\n
        2010-01-22: 0.4 (beta10)<\/h4>\n\n
          \n
        • Fixing email_cc<\/li>\n<\/ul>\n\n
          2009-11-04: 0.4 (beta6)<\/h4>\n\n
            \n
          • Adding filters for plain text emails generated.<\/li>\n
          • Adding option\/shortcode param (form_)email_include_empty_fields<\/code> to force empty fields to be included in emails.<\/li>\n<\/ul>\n\n
            2009-10-29: 0.4 (beta5)<\/h4>\n\n
              \n
            • Adding min<\/code> and max<\/code> checks to number form inputs.<\/li>\n<\/ul>\n\n
              2009-10-15: 0.4 (beta2)<\/h4>\n\n
                \n
              • Adding add_filter('form_email_message', 'wp_filter_post_kses')<\/code> and some other email sanitation checks, just in case.<\/li>\n
              • Now doing stripslashes()<\/code> on request params regardless of get_magic_quotes_gpc()<\/code> or get_magic_quotes_runtime()<\/code> (WordPress always escapes the global request params in wp-settings.php)<\/li>\n<\/ul>\n\n
                2009-10-06: 0.4 (beta)<\/h4>\n\n
                  \n
                • Non-empty HTML elements are ensured to not get serialized with XML shorthand\nempty syntax (space now not required in p<\/code>)<\/li>\n
                • Handling of file<\/code> input types. <\/li>\n
                • The data-email-label<\/code> attribute can now be supplied on the\n  input element, not just the label<\/code> element.<\/li>\n
                • Stubbed validation for url<\/code>, number<\/code>, and\n  range types<\/li>\n
                • Multiple forms are now allowed on a single page. A hidden<\/code> field\nnamed '_form_name_submitted' captures the name of the form that is submitted so the\nserver can match up the request with the corresponding form.<\/li>\n<\/ul>\n\n
                  2009-09-29: 0.3.9<\/h4>\n\n
                    \n
                  • Initial release<\/li>\n<\/ul>","raw_excerpt":"DRY forms (don't repeat yourself) which validate themselves server-side. Form results can be emailed. Hooks and options make plugin very flexible …","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/45128","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=45128"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/westonruter"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=45128"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=45128"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=45128"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=45128"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=45128"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=45128"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}