Newscoop 4 Cookbook

Subscription form

Form - Subscription

Purpose:

Generate the form and default data fields for subscription. Edit and Select statements can be used to generate fields for every section in an issue.

Syntax:

{{ subscription_form type="<subscription_type>"                           [template="<template_name>"]                           submit_button="<button_name>"                           [total="<total_field_name>"]                           [html_code="<html_code>"]                           [button_html_code="<html_code>"] }}    <list_of_instructions> {{ /subscription_form }} 
  • <subscription_type> has two values: by_publication and by_section
  • <template_name> is the name of the next template to be requested from the subscription form
  • <button_name> is the name of the button for submitting the form
  • <total_field_name> is the name of the field where the total payment is written
  • <evaluate_button_name> is the name of the evaluate button (when pressing this button, the total payment is updated in the total field
  • html_code: you can insert whatever HTML code you want in the <form> statement; for example: {{ user_form .. html_code="id=\"my_id\"" }}
  • button_html_code: you can insert whatever HTML code you want in the button input field statement; such as: {{ user_form .. button_html_code="id=\"my_submit_id\"" }}

Constraints:

Cannot be used inside user and login forms. Cannot be used within itself (for example: subscription in subscription).

Edit Subscription

Purpose:

Generates an input field for editing the subscription time for a certain section. The section must be defined in the template environment. This statement should be used inside the subscription form.

Syntax:

{{ camp_edit object="search" attribute="time"                              [html_code="<HTML_code>"]                              [size ="<field_length>"] }} 

Constraints:

The subscription edit field can only be used inside the subscription form.

Select Subscription

Purpose:

Special-purpose input for subscription data.

Syntax:

{{ camp_select object="subscription" attribute="<attribute>"                                      [html_code="<HTML_code>"] }} 

Filters:

<attribute> being one of the following:

  • section: generates a checkbox for selecting the current section in the subscription form; use together with "List of Sections" (see also "Creating reader subscriptions through the template language")
  • allLanguages: generates a checkbox allowing the user to choose a subscription to all available languages
  • languages: generates a multiple selection list allowing the user to select individual languages; this selection list is automatically deactivated if the user chose to subscribe to all available languages.

Constraints:

The select subscription field can only be used inside the subscription form.