Skip to main contentSkip to main navigationSkip to footer content

TVCC Admissions Office

Documentation

The TVCC Course Catalog implementation includes a variety of page types and two different outputs - cfm for web and pdf. Within the catalog there is a mix of manually edited content and dynamically generated content. Dynamic content is pulled from XML files, and manually edited content can be supplemented with a range of CSS styles and HTML snippets.

Switching Sites

If a user is editing a page in the main site, they may switch over to the catalog site by selecting the "Change Site" link. This link appears in the top-right corner in the blue OUCampus header. Then, the user should select "catalog". This will bring the user to the root of the catalog site. From there, the user should navigate to the version of the catalog they wish to edit. For example, "/current/" or "/working".

 

Linking in the Catalog

Links in the catalog should be page-relative, unless the link appears in an include file. Additionally, Dependency Manager should be turned "Off".

 

Creating and Editing Web Content

Interior SectionInterior Page

 

Web pages can be created using the New Interior Page template.

New web sections can be created using the New Interior Section template.

 

There are two layouts that can be displayed on a web page, one or two column. A user may select which columns to display at page creation, using the New Interior Page template, or after page creation by going to the Page Properties screen. If a created page is switched from two columns to one column, the content in the second column is saved, but not displayed.

 

Special WYSIWYG Features

There are also CSS classes and HTML snippets that can be used for web content.

Users may select the snippet icon from the WYSIWYG menu to open up the snippets dialogue. Snippets in the category "Web" may be selected for web pages. 

At delivery, there is only one snippet, "Table to divs". This snippet should be used to create table that, outside of the editor, is displayed using a div structure instead of an HTML table.

 

It is not required to use this snippet to create tables. For example, a user may create his or her own table that does not transform into divs. Alternatively, a user may decide later on to modify their table into a table that transforms into divs by selecting the table and clicking on the Insert/Edit table icon in the WYSIWYG editor. Under the Class dropdown, the class "Table to Div" may be selected.

 

To further customize this special table, CSS classes can be used to define each column width. Note that for optimal display, users should ensure that the columns widths they apply add up to "100". Users should add the numbers appearing after "t", which are displayed in light gray in a cell with the special class.

 

To apply a width to a column, users will:

 

  1. Highlight all of the cells in the desired column, to edit all of the highlighted cells at once
  2. Select the icon "Table Cell Properties" in the WYSIWYG editor
  3. In the dialogue that pops up over the editor, click on the arrow in the Class dropdown
  4. Select a class that follows format, "txx Width XX%".

It is possible for some rows to have columns of different widths, so long as they add up to 100. However, this will not be displayed properly in the WYSIWYG editor.

 

Example Table-to-div
April 18
TVCC Assessment Summit
April 26
Last Day to Drop Classes Without "W", Declare an Audit or Request "S" or "U" grades
May 14
Summer & Fall Advising Day (No day classes will be held 8:00 am - 4:00 pm)
May 20
Registration for Fall Begins
May 24
Last Day to Withdraw from Classes Without Responsibility for Grade
May 27
Memorial Day Observed (College Closed)
June 10-14
Final Exam Week
June 14
Commencement

Creating and Editing PDF Content (Regulatory Pages)

Regulatory SectionRegulatory Page

PDF pages can be created using the PDF Page template. This will create a page with both a web (cfm) output and a pdf output.

PDF Sections can be created using the PDF Section template. 

 

Creating and Editing Dynamic PDF Content (XML Driven)

Degree PageProgram Page

Many degrees and programs were generated and added to the implementation based off of the XML. However if new degrees or programs 

 

Full PDF Configuration

Global Edits

Page and Section Weights

catalog.pcf = Used to create a full PDF copy.

Global and Section-wide Content

Header and Footer content

Content that is displayed globally throughout the website is edited in the /_resources-22/includes/ directory. Each part of the header and footer is split into different files. When an include file is republished, this will update the entire site globally.

 

If global content has a dynamic element to it, then users will need access to /_resources-22/xsl/common.xsl to edit it. For example, the "Download PDF of this page" link is generated in the XSL only for pages that have a PDF output. 

 

Breadcrumbs

Breadcrumbs are both global and section-local. The first two links are edited in /_resources-22/includes/breadcrumb-start.inc. These links appear on all pages within the catalog web site. The following links are generated by the XSL that looks for a special properties file in each folder. Each folder contains a file called "_properties.pcf". Users may go to the Page Properties screen for this file to edit the name of that section. Users can then publish the file to make the changes effective.

 

Navigation 

Each version of the catalog may have its own navigation file. For pages that exist outside of a catalog version, the navigation from the /current/ folder is displayed. The navigation file is kept at the root level of the catalog version and is titled "_navigation.pcf". Users may edit the navigation using the WYSIWYG editor.

 

While editing in the WYSIWYG, users will be editing an HTML table. The first column is for the links that are displayed by default in the navigation. The second column is where optional links are added if the main link has a "popout". For the "Programs of Study" section, an asset is used that will generate the links to each program for the user. Lastly, users may use the Insert Row After icon in the WYSIWYG editor to add a new link. During preview and publish, the table is transformed into the correct HTML structure for the navigation.When this file is published, changes will be made globally for that version of the catalog.

 

Degree XML Process

Here is an overview of the degree process. Note that it is similar for courses as well. You can think of these steps as going backwards - first defining functions/templates and then finally the code that executes the function is reached.

1. Defined in xsl/_pdf/_shared/catalog-functions.xsl, is the function named "ou:getMajorXML" that simply translates the data XML into another XML format. The reason for this is because, if data XML format changes, such as a name of a node, then instead of changing many XSLs you only need to change it in one spot.

2. Defined xsl/_shared/degree-program.xsl is the template that defines the HTML structure. It uses the translated XML produced by catalog-functions.xsl. (Note that the PDF version of this file is xsl/_pdf/_shared/display-program-degree.xsl)

3. Finally, xsl/degree.xsl uses both of these XSLs. First, it uses getMajorXML to build the XML for the major specified in Page Properties, and stores it into a variable. It then runs that XML against the template to get the HTML output. 

 

Managing XML Files

All XML files are created on the MyTVCC website under MyTools, Catalog admin. Using the MyTVCC tool you can manage what data is stored in the XML files.  When you are ready you can use the MyTVCC tool to run the "Create XML file for ... ".  This will create the XML and then copy to the webserver.  You do not need to upload these files to OU Campus.

 

Managing Archives

To manage the catalog archives you need to use the MyTVCC, MyTools, Catalog Admin tool to copy the current catalog PDF files to the correct location with the correct name.  Once you have run the copy tool you can then edit the file inside OUCampus under /currnet/archives.pcf and add a link to the archive pdf file.  You can browse by looking at the production or development site.  Do not use the staging site as you wont see the pdf files under the staging.