zkaffold 0.0.11

参数

通常，在创建对象时，人们会想要指定字段的值。为此，请向代表新对象的元素添加一个params子元素，该子元素本身应包含一个代表每个字段的param元素。该param标签应将name属性设置为相关字段的名称，将type属性设置为text、lipsum、lipsum_html、reference、image、file、boolean、list或reference_list之一。然后，param元素包含应赋予该字段的价值。不需要为内容类型的每个字段指定param元素，如果未指定字段，将使用默认值。

将type属性设置为lipsum或lipsum_html的param元素具有可选的paras属性，该属性指定生成该字段值的Lipsum段落数。它们也不包含子元素。lipsum值导致生成带有换行符的普通Lipsum，而lipsum_html生成带有必要的段落标签的Lipsum。

<site>
  <my_folder>
    <MyContentType id="my_new_obj">
      <params>
        <param name="title" type="text">My new object</param>
        <param name="text" type="lipsum_html" paras="5" />
        <param name="isNew" type="boolean">True</param>
        <param name="old_obj" type="reference">/my_folder/my_obj</param>
        <param name="thumb" type="image">new_obj_thumb.jpg</param>
      </params>
    </MyContentType>
  </my_folder>
</site>

如上例所示，引用作为引用对象的路径字符串给出。图像和文件作为相对于XML文件目录的文件名给出。

多值参数

对于可能包含多个值（如ReferenceList或LinesField）的字段，param元素采用type属性list或reference_list。然后它应包含一个items元素，该元素包含零个或多个具有适当type属性和作为其内部XML的值的item元素。

<site>
  <my_folder>
    <MyContentType id="my_new_obj">
      <params>
        <param name="title" type="text">My new object</param>
        <param name="options" type="list">
          <items>
            <item type="text">Option 1</item>
            <item type="text">Option 2</item>
          </items>
        </param>
      </params>
    </MyContentType>
  </my_folder>
</site>

接口

有时可能需要向对象添加它们自动不提供的接口，尤其是标记接口。这可以通过使用 interfaces & interface 标签来实现，如下所示

<site>
  <my_folder>
    <MyContentType id="my_new_obj">
      <interfaces>
        <interface>identifier.of.IMyMarker</interface>
        <interface>identifier.of.IReplacementObject</interface>
      </interfaces>
      <params>
        <param name="title" type="text">My new object</param>
      </params>
    </MyContentType>
  </my_folder>
</site>

这将把指定的接口添加到对象中。

已经应用到对象上的接口可以通过将 interface 元素替换为 remove 元素来类似地移除，如下所示

<site>
  <my_folder>
    <MyContentType id="my_new_obj">
      <interfaces>
        <remove>IMyMarker</remove>
      </interfaces>
      <params>
        <param name="title" type="text">My new object</param>
      </params>
    </MyContentType>
  </my_folder>
</site>

设置文件夹对象的默认页面

要设置新或现有文件夹对象的默认页面，请使用具有 setDefaultPage 属性的 modify 元素

<site>
  <my_folder>
    <modify setDefaultPage="my_new_obj">
      ...
    </modify>
  </my_folder>
  <FolderishType id="another_folder">
    <modify setDefaultPage="folder_home" />
    <params>
      ...
    </params>
    <ContentType id="folder_home">
      ...
    </ContentType>
  </FolderishType>
</site>