範本語法和語義

每個範本都由一個或多個 XML 格式的角色範本 (member.xml、owner.xml、 visitor.xml、deleted.xml、disabled.xml) 組成。範本目錄包含它所服務之角色的 XML 檔案，例如，用於社群成員的 member.xml、用於社群所有者的 owner.xml，以及用於社群訪客的 visitor.xml。

每個角色範本都是該角色的社群使用者的顯示設定檔文件。檔案必須以顯示設定檔 DTD 為基礎。

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">
<DisplayProfile version="1.0" priority="%COMMUNITY_DP_PRIORITY%">
	<Properties/>
	<Channels>
		<Container name="%COMMUNITY_CONTAINER%" provider="JSPTableContainerProvider">
			<Properties>
				<String name="title" value="%COMMUNITY_NAME%"/>
				<String name="description" value="%COMMUNITY_DESCRIPTION%"/>
				<Boolean name="compileToRealPath" value="true"/>
			</Properties>
			<Available>...</Available>
			<Selected>...</Selected>
			<Channels>...</Channels>
	</channels>
	<Providers/>
</DisplayProfile>

在建立社群時，範本引擎會使用實際值動態替代顯示設定檔中的下述記號 (由 % 括住)。

%COMMUNITY_NAME%

為社群指定 (對使用者友善) 名稱。例如，tourists。

%COMMUNITY_ID%

指定識別群組的唯一字串。此名稱僅用於內部表示，不會在使用者介面中公開。例如，jdo__tourists。

%COMMUNITY_DESCRIPTION%

包含社群的描述。

%COMMUNITY_CONTAINER%

指定社群的頂層容器。例如，jdo__touristsContainer。

%COMMUNITY_DP_PRIORITY%

指定合併了產生社群顯示設定檔的優先順序的顯示設定檔。會為每個角色提供不同的值。預設情況下，訪客角色、成員角色和所有者角色的值分別為 1000、1005、1010。

%COMMUNITY_SEARCH_URL%

指定社群的搜尋伺服器 URL。

%COMMUNITY_CONTENTS_SEARCH_DB%

指定社群內容的搜尋資料庫。

%COMMUNITY_DISCUSSIONS_SEARCH_DB%

指定討論資料庫。

%PORTAL_ID%

指定入口網站的 ID。例如，portal1。