Content Submission
Author: Steven Pease
1. Introduction
This guide will quickly walk you through installing and configuring a PHP script that can be published to a live, production website that allows a user to submit an event into the Cascade Server calendar; then have it go through workflow. It assumes that you have a recent version of PHP (5 or greater) installed on your web server and that you are comfortable with Cascade Server. Knowledge of PHP and HTML is also useful, but not necessary to use this guide.
2. Components
There are four components to the script including the script itself, a form page, a configuration page, and a data definition to render the configuration page. The form page will submit content to the PHP script. The script will then read its configuration from the configuration page that you will publish with the use of the data definition provided. The configuration page will inform the PHP script how to add the content to the CMS, and the script will make the appropriate web services call to do so.
3. The Configuration Page
Create a page called "content-submission-config.xml", and give it a .php publish extension. Then give it the "content-submission-config-data-definition.xml" data definition. Supply a valid server URL, username, password, a name of the workflow to be instantiated when content is submitted, the path of the workflow definition to be used, and comments you wish to add to the workflow for each time you submit another calendar event to the CMS.
4. The Form Page
Create a page called "submit-content.html", and then paste the "content-submission-form.html" XHTML into the page's content WYSIWYG editor. Publish this page, "content-submission-config.xml", and "content-submission.php" in the same folder, and your script will be ready for use.
5. Usage
To use the script, upload the script to your CMS, and publish it. Fill in all fields in the configuration page, and then publish it as well. Once both of these are published, load the "submit-content.html" page from your server. After filling out all the information in the form, click "Submit", and a new calendar event with the provided system-name will be subjected to the workflow definition information provided in the configuration page.
Example Files
- content-submission.zip
This is a zip file with all the necessary scripts and XML. - content-submission-php.txt
This is the main PHP script. - content-submission-config-xml-php.txt
This is an example XML config file. - content-submission-config-data-definition.xml
This is a data definition to visually control the XML config file. - content-submission-form-html.txt
This is an example HTML form for submitting the content from the live site.