| <!ELEMENT sapi:qc (sapi:qc*, sapi:author*, sapi:comments?, sapi:apply*)> <!ATTLIST sapi:qc -- query container -- name %Text #REQUIRED -- container name -- title %Text #IMPLIED -- container title -- system %Text #IMPLIED -- system code -- ns %Text #IMPLIED -- namespace -- status %Text #IMPLIED -- container status -- mdate %Datetime #IMPLIED -- date of latest modification -- accessarea %Text #IMPLIED -- defines access modes of document, in which this element displayed -- > |
Start tag: mandatory, End tag: mandatory
Attributes definition
name = %Text [CN]
Mandatory. The value of this attribute contains the data container name.
title = %Text [CI]
Recommended. The value of this attribute contains the data container title that specifies the container in the list.
system = %Text [CN]
Deprecated. If an element contains this attribute, its value specifies the CMS system programming language used in the body.
ns = %Text [CN]
Optional. The value of this attribute contains a pointer to the namespace assigned to the given data container.
status = %Text [CN]
Optional. If an element contains this attribute, its value specifies the status of the container activity.
mdate = %Datetime [CN]
Optional. This attribute contains the date and time of the latest document modification.
accessarea = %Datetime [CN]
Not required. This attribute defines access modes of document, in which this element displayed. Value can be "edit", "view", "global".
Query containers refer to the fragments of the displayed document. The content of these containers can be modified by the CMS administrator. A container can be called from the presentation template of the displayed site document, or from other containers through the SAPI:APPLY element (see section 6.4.3) or through the SAPI:%Attribib attribute (see section 6.4).
These containers contain the code of user data queries and their related formatting.
Example of a query container:
| <sapi:qc name="var1" title=" Example of a query container "> <input class="special" name="post_data[qvar1]" sapi:value="this.value" /> </sapi:qc> |
6.3.2.1 Attribute name
Attributes definition
name = %Text [CN]
Mandatory. The value of this attribute contains the data container name.
This attribute contains the data container name that identifies the object in a SAPI document (see Objects of SAPI Documents). The container content (the data it refers to) can be called using the SAPI:APPLY element.
6.3.2.2 Attribute title
Attributes definition
title = %Text [CI]
Recommended. The value of this attribute contains the data container title that specifies the container in the list.
This attribute should not be ignored. A short but an informal container description will help to avoid errors during site configuration.
6.3.2.3 Attribute system
Attributes definition
system = %Text [CN]
Deprecated. If an element contains this attribute, its value specifies the CMS system programming language used in the body.
In the body of data containers a direct reference to the programming language code (that governs the parser) is allowed. In some cases this feature may simplify the definition of functional algorithms. However, using a system programming language in a data container body may cause difficulties at functional solutions exchange through SAPI Works Gallery. Users of the CMS handled by a different programming language will not be able to utilize this functional solution.
6.3.2.4 Attribute ns
Attributes definition
ns = %Text [CN]
Optional. The value of this attribute contains a pointer to the namespace assigned to the given data container.
6.3.2.5 Attribute status
Attributes definition
status = %Text [CN]
Optional. If an element contains this attribute, its value specifies the status of the container activity.
This attribute can be either omitted in an element or available with value “hidden”. By default, and in case there is no attribute in the element, the container is processed by the parser. If attribute “hidden” is provided, the parser ignores the container.
6.3.2.6 Attribute mdate
Attributes definition
mdate = %Datetime [CN]
Optional. This attribute contains the date and time of the latest document modification.
