orchard文檔之-建立自訂表格單

文章目錄

• 啟用自訂表格單模組
• 添加一個新內容類型
• 建立一個自訂表格單組件
• 查看提交的自訂表格單資料
• 匯出自訂表格單資料

建立自訂表格單

 自訂表格單（Custom Forms） 模組用來在前台收集網站訪問者的資訊，自訂表格單與一個內容類型組合起來工作，自訂表格單可以用來建立聯絡我們和訂閱等頁面或組件. 資訊儲存在orchard中，可以在以後匯出。

啟用自訂表格單模組

自訂表格單模組與一種內容類型組合起來在前端收集使用者輸入。提交的資訊被儲存起來用匯入-匯出模組（Import-Export-Module)匯出. 讓我們從管理菜單的模組部分啟用自訂表格單開始.

一旦模組啟用了模組，在導覽列的左邊會出現一個新的"Form"連結。如前所述，自訂表格單的工作原理是在網站的前端建立一個與一種內容類型（Content Type)相關的提交表單

在admin的Form部分，如果“Add a new Custom Form”選定後，一個目前存在於CMS中預設的內容類型的下拉式清單出現， a drop-down list in the next screen for the content types will show all of the default content types that exist currently in the CMS.然而，讓我們看看在右邊(AsideSecond zone)添加一個組件用來要求遊客加入一個郵件清單。唯一的收集資訊是使用者的email地址

添加一個新內容類型

為了收集和儲存使用者的email地址，我們需要在orchard中建立一個新類型。在admin菜單中，找到"Content Type"標籤，選擇創"建新類型"按鈕,把新類型命名為  'Subscribe Form'.

下一頁詢問你是否需要保持其它Part到建立的"Subscribe Form"內容類型，由於我們希望收集使用者的email地址，不選擇其它任何選項，按"儲存"按鈕。現在我們有了一個新的內容類型，我們想為email添加一個" input field" 。

在名稱裡輸入 'Email'，添加和儲存“input field”後，我們可以自訂新的輸入欄位的驗證規則，選擇輸入類型為Email.你也可以自由地選擇其它輸入類型。

這樣，我們就有了在右邊建立一個新的widget的所有材料。我們啟用了自訂表格單模組，建立了一個新的內容類型(Subscribe Form) 用來收集使用者的email地址，剩下的就是建立一個組件（Widget）.

建立一個自訂表格單組件

在管理導覽列的左邊選擇 Widgets ，在AsideSecond 地區找到合適的 Add 按鈕，添加自訂表格單組件.

剩下的事情就是調整我們新的自訂表格單組件的設定了，在這個例子在，層（ layer）設定為  'Default' ，位置設為 '1'.這樣組件會在所有頁面的右邊的頂部顯示。下面是本例的設定:

儲存後瀏覽網站，檢查新的特徵。

備忘: 如果輸入欄位顯示出了作者，要移除的話在 Subscribe Form類型中的Common Part中不選 'Show editor for owner' .

查看提交的自訂表格單資料

此時，我們啟用了自訂表格單，為自訂表格單建立了一個新的內容類型，在所有頁面的右邊添加了一個自訂表格單組件 。提交的資訊因為我們選擇了'Save the item once the form is submitted'而被儲存下來了那麼資料儲存在哪？有兩種方式查看提交的資訊，第一是選擇選擇在"admin“功能表列選擇"Form"連結：

第二個是從內容類型中選擇.如：

匯出自訂表格單資料

剩餘的事情是匯出提交的email地址，用來出版物，競選監視，郵件分發等等。在orchard CMS中最容易的輸出任何事情和所有事情的方法是使用  Import/Export 模組.  Import/Export 模組預設安裝在1.6版本中，但預設沒有開啟。讓我們啟用 Import/Export 模組.

Import/Export 功能現在在admin的導覽列可用了. 在 Import/Export 選項的頂部選擇'Export'標籤，出現所有可用的內容類型. 為了匯出email列表，勾選 Subscribe Form 。在底部有一些匯出設定選項，第一個選項中繼資料（Metadata）, 會包含內容類型的定義.選擇這個選項可用方便的從一個Orchard CMS網站copy內容到另外的orchard 網站。主要的例子是可以從一個開發網站遷移內容到生產網站。當匯入一個包含了中繼資料與資料的xml檔案時, Orchard 將建立內容類型拷入包含的資料。

在這個例子中，我們只對匯出資料感興趣，所以不需要勾選中繼資料選項。並且，確保選擇了"Draft Only",因為前台輸入的項目有發布狀態。

匯出的是XML檔案，可以用 MS Excel 開啟和編輯. 網站不僅能設計訪問者的email地址，儲存下來方便將來匯出，自訂表格單也是一個很好的實現聯絡我們或其它類型用來收集使用者資訊的工具。