News Site

Article Types

CMS Demo: Creating Internal & External Articles

News sites have two article types: internal and external. The internal article template is used for in-house stories written by your college/department. The external article allows colleges/departments to link to other internal CMS articles or those produced outside of USF (i.e. other news outlets such as Tampa Bay Times). 

Internal Article

Create

  1. Navigate to the appropriate year folder within your news folder (i.e. 2023).
  2. Click "+ NEW" at the top righthand corner and select "Internal Article".
    Image of the internal article pop up screen. The image displays the fields required to create the new internal article. Fields included are Article Title, Article Layout, Filename and Overwrite Existing.
  3. A news article pop-up will appear (pictured above).
  4. Enter the Article Title — typically the story's headline.
  5. Select the Article Layout: One-Column or Two-Column
    1. One-column will display your widgets at the bottom of the article layout.
    2. Two-column will display your widgets to the righthand side of the article. This will also determine the type of hero options available.
  6. Enter the Filename — typically a shortened version of the headline.
    1. For example, if the headline is "USF is a great university", the filename could be "usf-great-university.pcf".
    2. Remember to use lowercase letters and numbers only, with words seperated by dashes.
  7. If you are overwriting an existing file (replacing an article with the same filename), check the "Overwrite Existing" box.
  8. Select "CREATE"
    1. The next screen will look similar to a text page.

MultiEdit

In the MultiEdit section, you can update the internal article's details and look and feel.

  1. Make sure the article is checked out by clicking the lightbulb icon (it should be yellow). Click "MULTIEDIT" at the top righthand corner.

Article Layout

Screenshot of the Article Title field in an internal news article in MultiEdit.
  1. When initially building an internal article, you selected between a One-Column or Two-Column Article. However, you can change the layout in this section.

Article Details

Screenshot of the Article Details fields in an internal news article in MultiEdit.
Title
  1. When initially building an internal article, you created the Title. However, you can change it in this section.
Author Display
  1. Select whether you would like the author's name to be displayed on the article.
Author
  1. Enter the author's name in the text field.
Publish Date
  1. Select the publish date you would like the article to display. Please note: If the Publish Date field is left blank, the article will not appear on the Listing page.
Article Type Display and Article Type Icon
  1. You can choose to have an icon appear next to your article on the listing page to indicate the type of story: Text, Video, Image, or Audio. Choose "Yes" or "No" in the Article Type Display dropdown and choose the corresponding Article Type Icon (if "Yes" was selected).

Listing Details

Screenshot of the Listing Details fields in an internal news article in MultiEdit.
Listing Display
  1. You can choose to have your internal article appear on the Listing Page of your news site. Choose "Yes" or "No" in the Listing Display dropdown.
Listing Summary
  1. Create a brief description of the article and enter it in the Listing Summary text field. The Listing Summary will display below the Listing Image on the Listing Page.
Listing Image*
  1. Select the image you would like displayed with the article on your Listing Page by clicking the Dependency Manager icon.
    Screenshot of Dependency Manager of Listing Image in MultiEdit in news site.
  2. Navigate to the correct folder to locate the image and click "INSERT".
    Screenshot of choosing an image in the Dependency Manager of the Listing Image in MultiEdit in news site.
  3. It will then populate the image's Dependency Tag.
    Screenshot of dependency tag for image on news module
  4. Create a description for the image and enter it in the Image Description text field. This serves as alternative (alt) text for the image and is important for accessibility
  5. Note: A Listing Image must be included on all articles (even if using a Default Listing Page) for all Listing Page elements to function correctly. The default Listing Image will suffuce if not you are not using an original image.

*Note: The image will only appear if you have an Enhanced Listing Page.  

Hero Image/Video Content

Screenshot of the Hero Image / Video Content details in MultiEdit in news site.
Display Hero?
  1. You can choose to display a Hero Image or Video at the top of your article. Choose "Yes" or "No" in the Display Hero dropdown.
Hero Type
  1. Users can choose between the following for Hero Types:
    Screenshot of the Hero Type in MultiEdit in news site.
  2. Select the Hero Type in the dropdown.
Image and Image Description
  1. If you selected a Hero Type with an Image, follow the Listing Image instructions for more information.
Display Hero Caption
  1. You can choose to display a Hero Caption to accompany your Hero Image / Video Content. Choose "Yes" or "No" in the Display Hero Caption dropdown.
YouTube Video Link
  1. If you selected a Hero Type with a Video, paste the entire URL of the video into the YouTube Link text field.
    Screenshot of Display Hero Caption and YouTube link within MultiEdit of news site
  2. Once completed, click "SAVE" in the the top righthand corner. 

Parameters

  1. Navigate to the Parameters section of your article (Properties > Parameters). Parameters allows you to edit your article's Title, Metadata, and other custom settings. 
    Screenshot of the Parameters of a news article

Title and Metadata

Title
  1. The Title area allows you to update the title of your article.
    1. Try to keep the title short and concise.
Description
  1. In the Description area, include a short summary of your story (including important keywords).
    1. This is the same description that shows up on Google (or other Search Engine Results Pages) searches.
Tags
  1. The Tags field is where you can enter Tags and Categories.
    1. Tags and Categories are created with a naming convention unique to your news site.
      1. For example, "News Business Tag:" and "News Business Category:".
    2. Please note: Categories are created when setting up your news site. If you need to create a new Category, please submit a CMS Support Intake Form.
  2. Add the appropriate Category or Tag to the article by typing the name in the Tags field. Please note: If the Tags field is left blank (i.e. no Category has been selected), the article will not appear on the Listing page.
  3. Learn more about Categories and Tags.
    Screenshot of Tag section in a news article Parameters section

Custom Settings - Social Sharing

Enabling Social Sharing populates three social buttons (Facebook, Twitter, and Linkedin) on your article that allows readers to share the article on their social media channels. 

Screenshot of Custom Settings in a news article Parameters section
Enable Social Sharing?
  1. You can choose to Enable or Disable Social Sharing on your article. Choose "Enable" or "Disable" in the 'Enable Social Sharing?' dropdown.
Social Image
  1. A default image will be shared from the article (if provided). However, you can provide an alternate photo to be displayed on social media.
    1. Select the image by clicking the Dependency Manager icon. 
    2. Navigate to the correct folder to locate the image and click "INSERT".
Social Image Alt
  1. Create a description for the image and enter it in the Image Description text field. This serves as alternative (alt) text for the image and is important for accessibility.

Edit

Now that you have set up all backend information for your article, the next step is adding your content.

  1. Make sure the article is checked out by clicking the lightbulb icon (it should be yellow).
    1. If you elected for your Hero Image or Video to have a caption, you will see an additional Edit button underneath the image or video.
      1. Click Edit to update the caption using the text-only WYSIWYG Editor.
      2. Once you are done editing the caption click Save.
        Screenshot of Edit button for news hero image or video caption
  1. Click Edit.
    Screenshot of Edit region in news article
  2. Edit as you would a Text Page (using the WYSIWYG Editor), but using the News-specific Snippets (if applicable).
  3. Once you finished editing your article, click Save.
  4. Publish to Test and/or Production.

External Article

Create

  1. Navigate to the appropriate year folder within your news folder (i.e. 2023).
  2. Click "+ NEW" at the top righthand corner and select "External Article".
    Screenshot of creating an external news article
  3. A news article pop-up will appear (pictured above).
  4. Enter the Article Title — typically the story's headline.
  5. Paste the entire article URL in the "Article Link" field.
  6. Enter the Filename — typically a shortened version of the headline.
    1. For example, if the headline is "USF is a great university", the filename could be "usf-great-university.pcf".
    2. Remember to use lowercase letters and numbers only, with words seperated by dashes.
  7. If you are overwriting an existing file (replacing an article with the same filename), check the "Overwrite Existing" box.
  8. Select "CREATE"

MultiEdit

In the MultiEdit section, you can update the internal article's details and look and feel.

  1. Make sure the article is checked out by clicking the lightbulb icon (it should be yellow). Click "MULTIEDIT" at the top righthand corner.

Article Details

Screenshot of article details in external article MultiEdit
Title
  1. When initially building an internal article, you created the Title. However, you can change it in this section.
Author Display
  1. Select whether you would like the author's name to be displayed on the article.
Author
  1. Enter the author's name in the text field.
Publish Date
  1. Select the publish date you would like the article to display. Please note: If the Publish Date field is left blank, the article will not appear on the Listing page.
Article Type Display and Article Type Icon
  1. You can choose to have an icon appear next to your article on the listing page to indicate the type of story: Text, Video, Image, or Audio. Choose "Yes" or "No" in the Article Type Display dropdown and choose the corresponding Article Type Icon (if "Yes" was selected).

Listing Details

Screenshot of the Listing Details fields in an internal news article in MultiEdit.

Listing Display
  1. You can choose to have your internal article appear on the Listing Page of your news site. Choose "Yes" or "No" in the Listing Display dropdown.
Listing Summary
  1. Create a brief description of the article and enter it in the Listing Summary text field. The Listing Summary will display below the Listing Image on the Listing Page.
Listing Image*
  1. Select the image you would like displayed with the article on your Listing Page by clicking the Dependency Manager icon.
    Screenshot of Dependency Manager of Listing Image in MultiEdit in news site.
  2. Navigate to the correct folder to locate the image and click "INSERT".
    Screenshot of choosing an image in the Dependency Manager of the Listing Image in MultiEdit in news site.
  3. It will then populate the image's Dependency Tag.
    Screenshot of dependency tag for image on news module
  4. Create a description for the image and enter it in the Image Description text field. This serves as alternative (alt) text for the image and is important for accessibility

*Note: The image will only appear if you have an Enhanced Listing Page.

Parameters

  1. Navigate to the Parameters section of your article (Properties > Parameters). Parameters allows you to edit your article's Title, Metadata, and other custom settings. 
    Screenshot of Parameters section of external article

Title and Metadata

Title
  1. The Title area allows you to update the title of your article.
  2. Try to keep the title short and concise.
Description
  1. In the Description area, include a short summary of your story (including important keywords).
    1. This is the same description that shows up on Google (or other Search Engine Results Pages) searches.
Tags
  1. The Tags field is where you can enter Tags and Categories.
    1. Tags and Categories are created with a naming convention unique to your news site.
      1. For example, "News Business Tag:" and "News Business Category:".
    2. Please note: Categories are created when setting up your news site. If you need to create a new Category, please submit a CMS Support Intake Form.
  2. Add the appropriate Category or Tag to the article by typing the name in the Tags field. Please note: If the Tags field is left blank (i.e. no Category has been selected), the article will not appear on the Listing page.
  3. Learn more about Categories and Tags.
    Screenshot of tags section in a news site
  4. Click Save.
  5. Publish to Test and/or Production.
    1. There is no Edit section for an external news article. Once you have completed all MultiEdit items, the article is finished.