PT Import Content Installation
Important: Ensure that the ADF is installed and functioning correctly before installing PT Import Content.
Contents
Installation/Setup
Each of the following steps should be completed fully and in the order presented:
Import Custom Elements
Import two custom elements into your site (via the Elements dialog located in the CommonSpot Site Administrator):
- Subsite Mapping
- Page Mapping
Note: these elements are located in the /ADF/apps/pt_import_content/exported_objects/ folder
Build CCAPI page
- Create a page in the root of your web site called CCAPI (confirm Anonymous users have "Read" access to this page and all of its elements.
- Add the following elements to this page:
- Subsite Mapping
- Page Mapping
- Give each element a unique name (e.g. "subsiteMapElement", "pageMapElement")
- Record the pageID of this new page
Note: The easiest way to get the pageID is to view the page source code. Examine the header of the document - you will notice a block of JavaScript with a variable called "jsPageID." The value of this variable is the pageID for the page.
Switch into Read Mode after creating this page.
Create Generic Content Template
- Create a new page, to be used as the Generic Content template. Typically, this page will derive directly from the Base Plus One and will be located in the root of the site.
- Place a Textblock Element on the page and give that element a name (e.g. "pageContent").
- Save this page as the Generic Content Template.
Note: Alternatively, you can use an existing content template as long as the template contains a named Formatted Text Block (with or without header) element.
Configure Site
- Add the following line to the init() function of your sites ADF.cfc (ADF.cfc is located in /yoursite/_cs_apps/ directory)
loadApp("PTImport");
- Copy the /pt_import_content/ folder from the /ADF/apps/pt_import_content/site_folder/ folder - into your sites /_cs_apps/ folder
- Copy the /config/ folder from the /ADF/apps/pt_import_content/site_folder/ folder - into your sites /_cs_apps/ folder
- Modify the ccapi.xml file located in /yoursite/_cs_apps/config/ directory. Use the information from the above two steps (Build CCAPI Page and Create Generic Content Template) to configure the <elements> node.
- Modify the ptImport.xml file located in /yoursite/_cs_apps/config/ directory to match your current sites environment. This file will contain the name of the CF Datasource used to access to your external data.
- Modify the Subsite Spread Sheet Mapping document located in the/yoursite /_cs_apps/pt_import_content/data/ folder
Note: make sure that the Content Creation API is enabled for your server (see the CommonSpot Developer's Guide for more info)
Build Import Dashboard Page
- Create a page and place a Custom Script Element on the page
- Configure the Custom Script Element to point to the file "main_controller.cfm" located in the /ADF/apps/pt_import_content/customcf/ directory