Cy Think Survey

Programmer's Guide to genpage.pl  

Almost all of the programs in the Cy Think Content Management System (CMS) each relate closely to a single database table. Other programs, such as genpage.pl, are quite independent of the database and its tables.

This procedure is for adding new functions to the system. In this case, however, the function being added is internal and the extent of user-involvement is clicking a button on the action menu. Therefore, this procedure is aimed at programmers.

This is the procedure.

1. The first step is to create the action menu button. We are focusing on genpage.pl so in JshGUI the program script filename will be genpage.pl.
   See Programmer's Guide to CMS Action Menus
   
   
2. When the user clicks a button in the Action Menu, the menu and security system gives control to the script and routing specified in JshGUI.pm. Therefore, this is where the code for the function must begin. Here are some of the functions in genpage.pl.
3. This first group of functions do the actual work of changing the system.
   • rebuild_METAS_only - This function rebuilds the metatag (.mta) file for a page.
   • update_HTML - This function rebuilds HTML pages.
   • build_file_list - This function builds the file list.
   • update_ring_HTML - This function builds the selected ring or album.
   • update_file - This function updates files.
4. These functions present menus and options and are not functions that make changes to the system.
   • select_pages - This function lets the user select pages
   • page_config_continue - This function continues the page configuration
   • select_a_ring - This function lets the user select a ring to be published.
   • select_content_type - This function lets the user select the type of content page to edit.
   • select_banner_type - This function lets the user select a banner type
   • select_metatag_type - This function lets the user select the type of content page to examine for keywords.
   • select_site_tool - This function lets the user select the site tool
   • file_edit_continue - This function lets the user select the file to edit, but if the user has selected the ring or album content type, it lets the user select the ring or album to edit.
   • ring_edit_continue - This function lets the user select the ring or album file to edit.
   • keyword_edit_continue - This function lets the user select the ring or album file to examine for keywords.
   • metatag_edit_continue - This function lets the user select the file to examine for keywords, but if the user has selected the ring or album content type, it lets the user select the ring or album to examine for keywords.
   • select_key_words - This function lets the user select key words
   • edit_file - This function lets the user edit a file
5. Write and test any code needed to implement any special functions.
6. Consider the application as a whole and think if any additional changes are needed. Make changes and fix the implementation as needed.

This procedure is abbreviated and high level. It is documented to prompt the programmer as to the needed steps and is not intended to be a detailed step-by-step procedures.