shortcodes<\/p>\n
You will configure the form using shortcodes
\nThe available shortcodes are:<\/p>\n
* [db_form] – Encloses your form.
\n* [input]
\n* [mail]
\n* [hidden]
\n* [textarea]
\n* [radio]
\n* [select]
\n* [checkbox]
\n* [submit]<\/p>\n
Each of those shortcodes, except [db_form], can handle specific attributes. Those attributes are:<\/p>\n
* label
\n* value
\n* name
\n* required<\/p>\n
Special attribute for [radio] and [select] is:
\n* description<\/p>\n
label<\/p>\n
This will be the label which will be returned infront of input fields, behind radio buttons and checkboxes and on the submit button
\nAny caption can be used.
\nDefault: NULL<\/p>\n
value<\/p>\n
Specify this attribute to either give input fields a standard text or to define the submit values of radio buttons and checkboxes
\nAny caption can be used.
\nDefault: NULL<\/p>\n
name<\/p>\n
The name attribute specifies in which column in your mySQL database the value should be submitted.
\nAny caption can be used.
\nDefault: NULL<\/p>\n
Important:
\nThe name-attribute needs to be identical with the column name in your mySQL database
\nNote:
\nDon’t use spaces neither within your name-attribute nor as your mySQL column name.
\nThis plugIn is not tested with spaces within the name-attribute.
\nrequired<\/p>\n
Use this attribute to set whether the field is required or not.
\nTakes only true and false as values.
\nDefault: false<\/p>\n
description<\/p>\n
This attribute can only be used with the [radio] and [select] shortcodes.
\nIt can be used to put a text in front of your radio buttons \/ select dropdown.
\nDefault: NULL<\/p>\n
shortcode example usage<\/p>\n
example 1<\/p>\n
Form to submit firstname, lastname and an e-mail adress.
\nFirstname and e-mail are required lastname isn’t.
\nE-Mail field will have the default value “xx@yy.zz”<\/p>\n
[db_form]
\n[input label=”Firstname *” name=”sql_firstname” required=”true”]
\n[input label=”Lastname” name=”sql_lastname” ]
\n[mail label=”E-Mail *” value=”xx@yy.zz” name=”sql_mail” required=”true”]
\n[submit label=”Send!”]
\n[\/db_form]<\/p>\n
example 2<\/p>\n
Form to submit the answer to 2 questions and an e-mail adress.
\nEverything is required.<\/p>\n
[db_form]
\n[radio description=”Choose your gender. *” label=”Male;Female” value=”m;f” name=”sql_gender” required=”true”]
\n[radio description=”What’s the right answer to 2+2? *” label=”3;7;4;2″ value=”3;7;4;2″ name=”sql_math” required=”true”]
\n[mail label=”E-Mail *” name=”sql_mail” required=”true”]
\n[submit label=”Transmit data.”]
\n[\/db_form]<\/p>\n
example 3<\/p>\n
Form to submit 2 text fields and the value of a checkbox.
\nOnly the checkbox is required.<\/p>\n
[db_form]
\n[input label=”Your location” name=”sql_location”]
\n[input label=”Your destination” name=”sql_destination”]
\n[checkbox label=”I’d love to use your plugIn” value=”yes” name=”sql_use” required=”true”]
\n[submit label=”Submit my choice.”]
\n[\/db_form] <\/p>\n
Note:
\nThe checkbox-shortcode can also work as an enclosing element. That’s especially useful whenever you want to use a lot of code or even HTML markup behind your checkbox.
\n[checkbox value=”yes” name=”sql_use” required=”true”]I’d love to use your plugIn[\/checkbox]<\/p>\n
mail message examples<\/p>\n
You can set up custom mail and mail confirmation messages including the values submitted by the frontend-user.
\nTo do so you have to use the field’s name-attribute enclosed in “%”.
\nIn addition to that you can use full HTML markup.<\/p>\n
See the examples below.<\/p>\n
example 1<\/p>\n
Corresponding to shortcode example 1<\/p>\n
Firstname:<\/strong> %sql_firstname% The mail you receive will look like this:<\/p>\n Firstname: user’s firstname example 2<\/p>\n Corresponding to shortcode example 2<\/p>\n Your user’s gender is <\/strong>%sql_gender%<\/strong> The mail you receive will look like this:<\/p>\n Your user’s gender is m https:\/\/wordpress.org\/plugins\/db-form\/<\/p>\n","protected":false},"template":"","class_list":["post-5783108","topic","type-topic","status-closed","hentry"],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/support\/wp-json\/wp\/v2\/topic\/5783108","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/support\/wp-json\/wp\/v2\/topic"}],"about":[{"href":"https:\/\/wordpress.org\/support\/wp-json\/wp\/v2\/types\/topic"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.org\/support\/wp-json\/wp\/v2\/topic\/5783108\/revisions"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/support\/wp-json\/wp\/v2\/media?parent=5783108"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
\n<\/strong>Lastname:<\/strong> %sql_lastname%
\n<\/strong>E-Mail:<\/strong> %sql_mail%<\/p>\n
\nLastname: user’s lastname
\nE-Mail: user’s e-mail<\/p>\n
\nand he\/she believes that <\/strong>%sql_math%<\/strong> is correct.
\nContact him\/her by mail: %sql_mail%<\/a><\/p>\n
\nand he\/she believes that 4 is correct.
\nContact him\/her by mail: mail@mail.mail<\/strong><\/p>\n