Ticket #531: forums-data format.txt

forums-data: root element: %version (user+, forum+, topic*, post*) if there are any posts, there must be at least one topic

user: user container: [%id] (login, pass, email, url?, incept?, title?, nicename?, status?, meta*)
forum: forum container: [%id %author] (title, incept?, content?, status?, meta*, forum*, topic*)
topic: topic container: %author %in [%id] (title, incept, status?, meta*, tag*, post*)
post: post container: %author [%id] (title?, incept, content, status? post*, meta*)

title: CDATA - no HTML
content: CDATA  - HTML that is displayed on page
incept: MySQL formatted timestamp (GMT)
status: (int) 0 = normal, 1 = deleted

tag: CDATA - literal, raw tag name
meta: CDATA - meta value %key

%id: type_# (e.g. forum_1, user_49283)
%in: id of parent object if xml element has no non-trivial parent
%author: user_# || user->login

<forums-data version="0.72">
        <user id="user_{ID}">
                <login>{user_login}</login>
                <pass>{user_pass}</pass>
                <email>{user_email}</email>
                <url>{user_url}</url>
                <incept>{user_registered}</incept>
                <title><![CDATA[{display_name}]]></title>
                <status>{user_status}</status>
                <nicename>{user_nicename}</nicename>
                <meta key="{meta_key}"><![CDATA[{meta_value}}]]></meta>
                ...
        </user>
        ...

        <forum "forum_{forum_id}">
                <title><![CDATA[{forum_name}]]></title>
                <content><![CDATA[{forum_desc}]]></content>
        </forum>
        ...

        <topic id="topic_{topic_id}" author="user_{topic_poster}" in="forum_{forum_id}">
                <title><![CDATA[{topic_title}]]></title>
                <incept>topic_start_time</incept>
                <status>{topic_status}</status>
                <meta key="topic_resolved"><![CDATA[{topic_resolved}]]></meta>
                <meta key="topic_open"><![CDATA[{topic_open}]]></meta>
                <meta key="topic_sticky"><![CDATA[{topic_sticky}]]></meta>
                <meta key="{meta_key}"><![CDATA[{meta_value}]]></meta>
                ...
                <tag><![CDATA[{raw_tag}]]></tag>
                ...

                <post id="post_{post_id}" author="user_{poster_id}">
                        <content><![CDATA[{post_text}]]></content>
                        <incept>post_time</incept>
                        <status>{post_status}</status>
                        <meta key="ip"><![CDATA[{poster_ip}]]></meta>
                </post>
                ...

        </topic>
        ...

</forums-data>