Tag 1.1 Form

The tag form allows your users to tag weblog entries on your site similar to how they would comment on entries. When users submit tags, those tags are added to the Tag module database. They are not, however, added to the contents of the custom tag field for the weblog entry. If you use the tag form you should not use the exp:tag:tags_from_field function, but rather use the more universal exp:tag:tags function.

Parameters
Form Fields

Parameters

{exp:tag:form form_name="some_form_name" return="template_group/template"} <div class="tag_form"> <h4>Add your own tags</h4> <div class="small">Each tag on a separate line</div> <p><textarea name="tags" cols="50" rows="4"></textarea></p> <p><input type="submit" name="submit" value="Submit" /> </div> {/exp:tag:form}

entry_id
form_name
return

entry_id

entry_id = "some_entry_id"

The 'entry_id' parameter allows you to override the entry id or url title pulled from the url of the page. In those cases where your page shows a number of weblog entries, each of which you want to accept tags, you should supply this parameter by feeding into it the entry_id variable from your weblog:entries tag. Like this entry_id="{entry_id}".

form_name

form_name = "some_form_name"

The 'form_name' parameter is used to establish the name and id of the tag form. This will allow you to use javascript on the form.

return

return = "template_group/template"

The 'return' parameter establishes where users will be sent upon form submission. By default, if this parameter is not provided, users will be returned to the same page.

Form Fields

One field is used with the tag form. It is called 'tags'.

tags