Content Type Framework

A new content type is actually made up of multiple (sometimes many) different classes. These define not only how users interact with its content, but also link the content type to application subsystems that add support for features found on other content types (including documents, discussion messages, blog posts, and so on).

Note: The content type API is still a new feature that might change as developers provide feedback about it.

Creating a Content Type Plugin (High-Level Steps)

Here's a high-level view of the steps to creating a new content type.

• Create a Jive object class to represent an instance of your content type.
  
• Create a Jive object type class to represent your content type and link it to feature subsystems. These subsystems support features that make instances of the content type taggable, commentable, searchable, and so on.
• Where needed, create info provider classes for those subsystems to which your content type will provide specific information.
• Create a plugin class to handle lifecycle needs, including registering and unregistering your content type with the system.
• Write a plugin.xml file to provide configuration details about your plugin.
• Write FTL files to render the content type's user interface.
• Create action classes to handle interactions between user interface and your content type's logic.
• Configure Spring, where needed, for injecting dependencies into your classes.
• Define the schema for database tables your content type will use for persistent data.

The following diagram describes the roles of each content type piece and how they integrate with the application.

Create Java Classes for the Content Type's Logic

You'll find Javadoc for the API on the Jive Software web site.

Jive Object Class

Your content type's Jive object class provides raw data about a single instance of your content type. This data includes the instance's name, ID, subject, body, and so on. For example, an instance of a document has a title (subject), a body that is its content, an ID that is its number in the system, and so on. Each of these bits of information is available from the Jive object class instance representing that document.

Jive Object Type Class

If your content type's Jive object class (above) represents data about a specific instance, then its Jive object type class represents information about the type as a category of content in the application. At a minimum, your class implements JiveObjectType, a required interface for a content type whose instance data is stored in the database. This interface provides methods through which the application can find out if the content type is enabled and through which it can create new instances of the type. (This class is also the one you'll register and unregister in your plugin class's lifecycle methods.)

But it's much more likely that you'll instead implement one or more interfaces that extend JiveObjectType. These signal which of the application subsystems your content type supports. In other words, it answers whether instances of the content type support features such as being commentable, taggable, watchable, and so on. Your Jive object type class will implement each of the subsystem interfaces as needed.

The following table lists the object type interfaces.

The following diagram shows a high-level view of the hierarchy of Jive object type interfaces.

Info Provider Classes and Other Supporting Types

Provide content type-specific support for the subsystem they're connected to. For some of the subsystems your content type supports, you implement certain of the info provider interfaces listed here. Your info provider class will provide subsystem-specific information about your content type.

For example, if your Jive object type class implemented the PermissionEnabledType interface to signal support for permissions setting, that class would return a PermissionInfoProvider implementation that described default view and create permissions for your content type.

The following table lists content type API interfaces that you implement to support specific subsystems.

Supporting Feature Subsystems

The following topics describe how to implement support feature subsystems -- commenting, tagging, and so on.

Core Content Type Features

Supporting Content Type Display on Container Lists

Supporting Content Type Display On Userbar Menus

<plugin xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="http://www.jivesoftware.com/schemas/clearspace/3_0/plugin.xsd">
    <name>memo-type-example</name>
    <description>Memo content type example.</description>
    <author>Jive Software</author>
    <version>1.0.0</version>
    <minServerVersion>3.0.0</minServerVersion>
    <databaseKey>Memo Example Plugin</databaseKey>
    <databaseVersion>100000</databaseVersion>

    <!-- URL mapping class -->
    <urlmapping prefix="/memos" class="com.jivesoftware.clearspace.plugin.test_dynamic.MemoURLMapping"/>

    <!-- sitemesh -->
    <sitemesh>
        <decorator name="default" page="default/template.ftl">
            <pattern>/memos/*</pattern>
        </decorator>
        <decorator name="default" page="default/template.ftl">
            <pattern>/memos*</pattern>
        </decorator>
    </sitemesh>

    <!--
        Specify the class that implements the Plugin interface. This has
        lifecycle methods through which you'll register your content type.
    -->
    <class>com.jivesoftware.clearspace.plugin.test_dynamic.MemoTypeExamplePlugin</class>

    <!-- Specify the CSS file whose rules will be used globally in instances of your content type. -->
    <css src="/resources/memo.css" />

    <!-- UI components that expose hooks to using your content type. -->
    <components>

        <!-- community -->
        <component id="community-actions">
            <tab id="community-actions-tab">
                <item id="jive-link-createMemo" name="memo.create.title" cssClass="jive-icon-med jive-icon-memo-med">
                    <when><![CDATA[( ObjectTypeUtils.isTypeEnabledForContainer(community, statics["com.jivesoftware.clearspace.plugin.test_dynamic.MemoObjectType"].MEMO_TYPE_ID) &amp;&amp; statics["com.jivesoftware.clearspace.plugin.test_dynamic.MemoPermHelper"].canWriteMemo(community) )]]></when>
                    <url><![CDATA[<@s.url action="memo-create" method="input"><@s.param name="containerType">${community.objectType?c}</@s.param><@s.param name="container">${community.ID?c}</@s.param></@s.url>]]></url>
                </item>
            </tab>
        </component>
    </components>
    <!-- Other UI components as needed. -->

</plugin>