Skip to content

group.xml ​

XML schema: group.xsd · Linking and validation.

group.xml extends group objects and group administration UI.

Use it when group records need additional attributes or when the group panel needs package-specific tabs.

Attributes ​

Add group attributes under <attributes>.

xml
<quiqqer xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="https://www.quiqqer.com/docs/schemas/2.x/group.xsd">
    <group>
        <attributes>
            <attribute>vendor.package.groupAttribute</attribute>
        </attributes>
    </group>
</quiqqer>

Use package-scoped attribute names for package data.

Group Panel Tabs ​

Use <window> to add tabs to the group administration panel.

xml
<window>
    <tab name="settings">
        <text>Settings</text>
        <image>fa fa-gears</image>
        <template>SYS_DIR/template/groups/settings.html</template>
    </tab>
</window>

Tabs can use templates or JavaScript callbacks such as onload.

QUIQQER reads the direct tab entries below the first window element. Keep tab names unique within the group panel.

Platform Shape ​

QUIQQER core defines group attributes and administration tabs:

xml
<quiqqer xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="https://www.quiqqer.com/docs/schemas/2.x/group.xsd">
    <group>
        <attributes>
            <attribute>description</attribute>
        </attributes>

        <window>
            <tab name="settings">
                <text>Einstellungen</text>
                <image>fa fa-gears</image>
                <template>SYS_DIR/template/groups/settings.html</template>
            </tab>
        </window>
    </group>
</quiqqer>

Practical Checklist ​

Before adding group.xml:

  • Use package-scoped attribute names for package data.
  • Add backend tabs only when administrators need group-specific UI.
  • Keep template paths stable.
  • Match template field names to the group attributes that should be saved.

Released under GPL-3.0-or-later.