Documentation on the Kentico CMS tool is available at

Size: px

Start display at page:

Download "Documentation on the Kentico CMS tool is available at"

Jennifer Green
6 years ago
Views:

1 Eau Claire Area School District Website Editor Documentation Test site: Live site: Documentation on the Kentico CMS tool is available at Contents Kentico Interface Basics... 3 Adding a New Page... 4 Editing a Page... 7 Widgets... 9 Announcements...9 Editable Text Widget Events Formatted List Latest News Media Gallery Promo Box Quick Links Testimonials Events Add Events to Calendars Edit Events on Calendars Add a New Calendar News Add News Article Edit News Articles Photos Media Library Assigning Edit Role to User Add a new Editor Appendix Navigation and Linking Guidelines Left Navigation Content section Right Rail SEO (Search Engine Optimization) SEO Guiding Principle Keywords Page 1 of 31

2 Page Title and Description Heading on Page Content on Page Images on Page Page Proofing Checklist Main Content Search Engine Optimization Page 2 of 31

3 Kentico Interface Basics The Dashboard: The Header: Pages application interface: Page 3 of 31

Adding a New Page 1. Click on the parent page in the Content Tree. 2. Click on the plus sign above the Content Tree. 3. Select Page (menu item) from the list of document types. 4. Enter the Page Name.

4 Adding a New Page 1. Click on the parent page in the Content Tree. 2. Click on the plus sign above the Content Tree. 3. Select Page (menu item) from the list of document types. 4. Enter the Page Name. 5. In the EauClaire / General Templates folder, choose a template. The most commonly used will be Columns and Columns a. Columns : Left nav, content section in the middle of the page, right rail. b. Columns 33-66: Left nav, larger content section (no right rail). c. Columns Full Width: No left nav (used only for special page such as search results). d. Use Home page only if creating a new site. 6. Click Save 7. Update Metadata for SEO under Properties (see SEO (Search Engine Optimization) section for details). Page 4 of 31

a. Page title: i. Format is: ECASD Descriptive title here ii. Approximately 70 characters max (with spaces). Anything longer will be cut off in the search engine results. iii.

5 a. Page title: i. Format is: ECASD Descriptive title here ii. Approximately 70 characters max (with spaces). Anything longer will be cut off in the search engine results. iii. Each page title should be unique. iv. The descriptive title will often be the same as the page name and that is OK. It should include words you think people would use when searching to find the content on the page. b. Page description: i. Approximately 160 characters max (with spaces). Anything longer will be cut off in the search engine results. ii. This appears in search engine results and should help sell the page. It must be accurate and descriptive. Do not include special characters, especially quote marks. iii. Each page description should be unique. Page 5 of 31

6 Page 6 of 31

Editing a Page 1. Click on Page in the top navigation options (if needed). 2. Enter text in the Editable Text widget (labeled main content). a. The first line should be the title of the page (should be the same as the Page Name).

7 Editing a Page 1. Click on Page in the top navigation options (if needed). 2. Enter text in the Editable Text widget (labeled main content). a. The first line should be the title of the page (should be the same as the Page Name). b. After typing the title of the page, select the text and choose Headline 1 in Format. c. Type or copy in the remaining text for the page. i. If pasting from another document, be sure to Paste as Plain Text. ii. Use Bold to highlight content or for sub-headings. Do not use underline or colors. iii. Do not list links to other pages within the section (they already appear in the left nav). 1. If needed, put a link within the text on the page. iv. You can add a bulleted list of links to documents or forms. v. Links will appear as blue text on the page. d. SAVE often! i. Info in an Editable Text area is only saved when you click SAVE. Don t click other choices without saving first. 3. If adding call-outs in the right or left rail: a. Click in the Menu icon for the widget zone (it is not labeled on the page). b. Choose Add new widget c. Click on ECASD, click the Widget you want to use and choose Select. d. Fill in needed information. See Widgets for more information. Page 7 of 31

e. To edit a widget, hover over the widget and

or smartphone screen size instead of the Default

8 e. To edit a widget, hover over the widget and click on the Configure (gear) icon. 4. To see what the page will look like on a tablet or phone, click on Preview, then select tablet or smartphone screen size instead of the Default screen size. (be sure to Save before Previewing) Page 8 of 31

Widgets Announcements Displays short pieces of text with a date that users can scroll through or click to view all. 1. In the Content Tree, click on the page where you want to place announcements. 2.

9 Widgets Announcements Displays short pieces of text with a date that users can scroll through or click to view all. 1. In the Content Tree, click on the page where you want to place announcements. 2. Click the Plus button and add a page named Announcements, click Save. 3. On the page, add the Announcements widget with the following specs: a. Path = Announcements page b. More Link URL = Announcements page c. Container title = Announcements or whatever you want to display as the label of the section. It will display in all caps. d. Click OK. 4. Save page. 5. Preview the pages with the widget to make sure it looks good. Page 9 of 31

10 6. Add announcements to the list: 7. Click Save a. Click on the Announcements folder b. Click the Plus sign c. Choose Announcement document type d. Enter a title this will appear as bold, colored text e. Enter the content this will be plain text displayed without any formatting f. Enter the date this will display with the announcement g. Publish from/to dates can be filled in to automatically publish/un-publish the announcement from the site. 8. Preview the pages with the widget to make sure it looks good. Page 10 of 31

11 Editable Text Widget Displays any text content. 1. On the page, add the Editable Text Widget. 2. The page will refresh with the text area displayed. 3. Save the page. 4. To add/change the title, click to Configure the widget and enter a Container Title. It will display in all caps. (Save after editing) 5. Preview the pages with the widget to make sure it looks good. Page 11 of 31

Events Displays a listing of events on the page. 1. A list of events is needed. You can use a list that has already been entered, or create a new list of events. (See Events section for details). 2.

12 Events Displays a listing of events on the page. 1. A list of events is needed. You can use a list that has already been entered, or create a new list of events. (See Events section for details). 2. On the page, add the Events widget with the following specs: a. Path = Event listing folder b. More Link URL = Event listing folder c. Select top N documents = enter the number of events you want to display on the page. If blank it will display all events. d. Container title = Events or whatever you want to display as the label of the section. It will display in all caps. e. Click OK. 3. Save page. 4. Preview the pages with the widget to make sure it looks good. Page 12 of 31

13 Formatted List List that can be used for Related links or similar lists. 1. On the page, add the Formatted List Widget. 2. The page will refresh with the widget with default displayed. 3. Save the page. 4. To change the content, edit directly on the page. The list is bulleted by default, but can be changed if needed using the editing tools. (save page after editing) 5. To add/change the title, click to Configure the widget and enter a Container Title. It will display in all caps. (save page after editing) 6. Preview the pages with the widget to make sure it looks good. 7. Usage guidelines: a. Links to related content in other sections of the site (should not duplicate a link in the left navigation unless it is really buried). b. Link text should be short and descriptive, most likely the same as the page title/link in the navigation. c. Try to keep the list to a reasonable size. Use section headings to group a long list into smaller sections for easy scanning. Page 13 of 31

Latest News Displays clickable news headlines in a list. 1. A list of news is needed. You can use a list that has already been entered, or create a new list of news. (See News section for details). 2.

14 Latest News Displays clickable news headlines in a list. 1. A list of news is needed. You can use a list that has already been entered, or create a new list of news. (See News section for details). 2. On the page, add the Latest News widget with the following specs: a. Path = News listing folder b. More Link URL = News listing folder c. Select top N documents = enter the number of headlines you want to display on the page. If blank it will display all headlines. d. Container title = News or whatever you want to display as the label of the section. It will display in all caps. e. Click OK. 3. Save page. 4. Preview the pages with the widget to make sure it looks good. Page 14 of 31

If the original photo is not a square, it will be stretched/squished into a square. 2. Go to the Media Gallery to check the location of the photos. The path will be needed.

15 Media Gallery Displays a photo gallery in a grid pattern. Clicking on a photo will open 1. Photos in the Media Gallery is needed. You can use a set of photos that has already been entered, or create a new set of photos. (See Photos section for details). Note: the photos will display as small squares. If the original photo is not a square, it will be stretched/squished into a square. 2. Go to the Media Gallery to check the location of the photos. The path will be needed. It is the name of the sections after your school name. In the example below, the path is /District/Home/. 3. On the page, add the Media Gallery widget with the following specs: a. Media Library = use the drop-down to select the media library (usually your school) b. Path = path to files (see #2 above) c. Select top N files = enter the number of photos you want to display on the page. If blank it will display all photos in the library. d. Container title = Photo Gallery or whatever you want to display as the label of the section. It will display in all caps. e. Click OK. 4. Save page. 5. Preview the pages with the widget to make sure it looks good. Page 15 of 31

16 Page 16 of 31

17 Promo Box Displays promotional text with optional image and button. It is intended only have a small amount of text. 1. On the page, add the Promo Box widget with the following specs: a. Headline = displays in bold b. Content = (optional) additional text to display in the boxpath = path to files (see #2 above) c. Promo URL = (optional) page or site (can be outside of ECASD) that button should link d. Link Target = either current window or a new window. Best practice is to choose current window if link is within the same site; choose new window if link will go to a separate site (either another school/district site or an outside site) e. Button text = (optional) text that will appear in the button. Text should be a short, descriptive call-to-action, eg: apply now, join now, donate, register, contact us, get started. f. Promo image = (optional) image that will display to the left of the text. It will automatically be resized to fit the available space. Image should have colored background or transparent background. Add Alternate Text that is descriptive and includes keywords if possible. g. Container title = Whatever you want to display as the label of the section. It will display in all caps. h. Click OK. 2. Save page. 3. Preview the pages with the widget to make sure it looks good. Page 17 of 31

18 Page 18 of 31

Quick Links Displays list of links with icons. 1. In the Content Tree, click on the page where you want to place Quick Links. 2. Click the Plus button and add a folder named Quick Links, click Save.

19 Quick Links Displays list of links with icons. 1. In the Content Tree, click on the page where you want to place Quick Links. 2. Click the Plus button and add a folder named Quick Links, click Save. 3. On the page, add the Quick Links widget with the following specs: a. Path = Quick Links listing folder b. Container title = News or whatever you want to display as the label of the section. It will display in all caps. c. Click OK. 4. Save page. 5. Preview the pages with the widget to make sure it looks good. Page 19 of 31

20 6. Add quick links to the list: 7. Click Save a. Click on the Quick Links folder b. Click the Plus sign c. Choose Quick Link document type d. Enter a title this will appear as bold, colored text e. Enter the link description this will be plain text displayed without any formatting f. Enter the link g. Choose the link type - Best practice is to choose current window if link is within the same site; choose new window if link will go to a separate site (either another school/district site or an outside site) h. Select the Quicklink icon Quick link lists should only use approved icons. Icons can be found in the Quick Links Icons media library. i. Publish from/to dates can be filled in to automatically publish/un-publish the quick link from the site. Page 20 of 31

21 Testimonials Displays testimonials or quotes users can scroll through. It is similar to Announcements widget but without dates. 1. In the Content Tree, click on the page where you want to place testimonials. 2. Click the Plus button and add a folder named Testimonials, click Save. 3. On the page, add the Testimonials widget with the following specs: a. Path = Testimonials folder b. Select top N documents = enter the number of testimonials you want to display on the page. If blank it will display all testimonials in the list. c. Container title = Testimonials or whatever you want to display as the label of the section. It will display in all caps. d. Click OK. 4. Save page. 5. Preview the pages with the widget to make sure it looks good. Page 21 of 31

22 6. Add quotes/testimonials to the list: 7. Click Save a. Click on the Testimonials folder b. Click the Plus sign c. Choose Testimonials document type d. Enter a title this is not displayed on the page. It is used to identify the testimonial in the Content Tree e. Enter the content this will be plain text displayed in italics f. Author this will display in bold at the end of the content g. Publish from/to dates can be filled in to automatically publish/un-publish the quote from the site. Page 22 of 31

23 Events The District and each School has a main events listing/calendar page. The School listing/calendar will automatically display District-wide events in addition to the events specific to the school. If desired, additional, calendars can be added for athletic, music, academic or other events that may or may not be included in the main school events listing. See the Add a New Calendar section for details. Add Events to Calendars 1. Click on the Calendar in the Content Tree (see Add a New Calendar section if calendar does not exist) 2. Click the Plus sign. 3. Select an Event document type 4. Enter the Event Name. This will display in bold in the event listings. 5. Enter the Event Summary. This will display as plain text on the event listings. Only the first characters will display in the Event widget display. The full text will display on the individual event listing. 6. Event details 7. Enter the Event location. This will display as Location: xxxxxxxx on the full event listings. It will not display in the Event widget display. 8. More info link 9. Enter Event Date and Time / End Date and Time. a. If the event is an all day event: enter just an Event Date and Time. Time does not matter, it is ignored by the system. b. If the event has a specific start/end time: enter an Event Date and Time and End Date and Time. Time does matter; date must be the same for both fields. c. If the event spans multiple days: enter an Event Date and Time and End Date and Time. Time does not matter, it is ignored by the system. If a start and end time is needed for a multiple day event the time detail will need to be included in the Event Summary. 10. Publish From/To dates can be used to control when an event appears on the site. NOTE: events prior to today s date will not appear from the event listings regardless of publish from/to dates. 11. Click Save. Page 23 of 31

24 Edit Events on Calendars 1. To edit an event that has already been entered, click on the event in the Content Tree. 2. Click Form in the top navigation. 3. See Add Event to Calendars (above) for details on the individual fields. 4. Click Save. Add a New Calendar 1. To add a new calendar, click on Events in the Content Tree. 2. Click the Plus sign. 3. Select Page (menu item) from the list of document types. Page 24 of 31

25 4. Enter the Page Name. 5. In the EauClaire / General Templates folder, choose the Columns Events template. 6. Click Save 7. Update Metadata for SEO under Properties (see SEO (Search Engine Optimization) section for details). a. Page title: 8. Add events. i. Format is: ECASD Descriptive title here ii. Approximately 70 characters max (with spaces). Anything longer will be cut off in the search engine results. iii. Each page title should be unique. iv. The descriptive title will often be the same as the page name and that is OK. It should include words you think people would use when searching to find the content on the page. b. Page description: i. Approximately 160 characters max (with spaces). Anything longer will be cut off in the search engine results. ii. This appears in search engine results and should help sell the page. It must be accurate and descriptive. Do not include special characters, especially quote marks. iii. Each page description should be unique. News Add News Article 1. Click on the News in the Content Tree (see Add News section if it does not exist) 2. Click the Plus sign. 3. Select an News document type 4. Enter the News Title. This will display in bold in the news listings. 5. Enter Release Date. This is the date that will appear on the news article. It does not control when the news will be published, use the Publish From/To dates to control publishing. Page 25 of 31

26 6. Enter the News Summary. This will display as plain text on the news listings. Only the first characters will display in the Latest News widget display. The full text will display on the individual event listing. 7. Enter the News Text. This is the full article content. 8. Teaser 9. Publish From/To dates can be used to control when a news article appears on the site. 10. Click Save. Edit News Articles 1. To edit a news article that has already been entered, click on the article in the Content Tree. 2. Click Form in the top navigation. 3. See Add News Article (above) for details on the individual fields. 4. Click Save. Page 26 of 31

Photos Media Library Each school and the district site have a Media Library. Additional folders can be added to a media library as needed to organize photos.

27 Photos Media Library Each school and the district site have a Media Library. Additional folders can be added to a media library as needed to organize photos. Photos can not be easily copied between Media Libraries, but users can use any photos from any Medial Libraries they have access to. Photos uploaded to the Media Library will be automatically resized to a maximum side size of 2000 pixels. Additional resizing may be done depending on where the image is used. Photos in the Media Library can be edited in Kentico. Assigning Edit Role to User Add a new Editor 1. In the Content Tree, click on the page. 2. Go to Properties > Security 3. Click on Add Users 4. Search to find specific user in the list. Click Select 5. With user highlighted in Users and Roles box, click the checkbox for permissions to assign. a. Modify = make edits usually all that will be needed for a user to be able to make minor updates. b. Full control = all options selected c. Create/Delete = add/remove pages, widgets d. Destroy = delete without option to recover e. Modify permissions = should not be assigned, user should retain admin ability for their own page. 6. Click Save. 7. Have the user test to make sure they can access what they need. Page 27 of 31

28 Appendix Navigation and Linking Guidelines Left Navigation Link to all pages of the site. Links can be grouped by adding sub-pages. Every link will have a page. Related Info (Formatted List widget) o Links to related content in other sections of the site (should not duplicate a link in the left navigation unless it is really buried). o Link text should be short and descriptive, most likely the same as the page title/link in the navigation. o List should not be more than 6 links per section (GSWISE, GSUSA). Content section Do not list links to other pages within the section. o That is in the left nav. o If needed, put a link within the text on the page. You can add a bulleted list of links to documents or forms. Right Rail Optional If nothing in the right rail, use Columns Page template so content section will stretch to cover the entire page. Page 28 of 31

SEO (Search Engine Optimization) 101 SEO Guiding Principle Search engines want to help searchers find high-quality content. Keywords What searchers will use when searching.

o o Have fewer searches, but can be easier to get high ranking. Can have higher click-throughs. Target 1-3 keywords per page.

29 SEO (Search Engine Optimization) 101 SEO Guiding Principle Search engines want to help searchers find high-quality content. Keywords What searchers will use when searching. Can be a single word, a phrase or a question. Search engines will find variations. Long tail keywords are specific phrases that can match your product exactly (or closely). o o Have fewer searches, but can be easier to get high ranking. Can have higher click-throughs. Target 1-3 keywords per page. Page Title and Description Page Title Page Description Page Title Used by search engines to determine page rank. Used by searchers to know who/what the page is about. Words used in search are shown in bold within search engine results. Format is: ECASD Descriptive title here Approximately 70 characters max (with spaces). Anything longer will be cut off in the search engine results. Each page title should be unique. The descriptive title will often be the same as the page name and that is OK. It should include words you think people would use when searching to find the content on the page (keywords). Page 29 of 31

30 Page Description Used by searchers to know who/what the page is about. Words used in search are shown in bold within search engine results. Approximately 160 characters max (with spaces). Anything longer will be cut off in the search engine results. This appears in search engine results and should help sell the page. It must be accurate and descriptive. Do not include special characters, especially quote marks. Heading on Page The first text on the page should be the title of the page with format Heading 1 (<H1>). It should be descriptive of the content of the page. It can match the Page Title in the Metadata. It is used by search engines to determine page rank. Content on Page Page content should include the word(s) used in the Page Title and Heading 1 as appropriate. Ideally the words are used 2-3 times, but don t force it it is more important for the page to read well and be easily understood. Images on Page Ideally the image name and the Alt Tag (Alternate Text) also include words used in the Page Title. Alternate Text can be entered when adding an image to a page. This is minor and can be considered if pages are not ranking well with search engines or there is heavy competition for a particular search term. Page 30 of 31

31 Page Proofing Checklist Main Content Page title is Heading 1 format. Pate title matches navigation title. Correct spelling and punctuation used. Spell-check and Grammar-check are available on each page. All text in Main Text area is same color and size. Bold used for sub-headings on page. Lists of content use bullets or numbers. Links are incorporated within content as needed. Lists of links to other pages in the section are not used. All links work. Search Engine Optimization Page Title is format ECASD Descriptive title here Page Title is maximum 70 characters (with spaces). Page Description is maximum 160 characters (with spaces). All images on page have Alternate Text (Alt Tag). Page 31 of 31

Illinois State University Events Calendar

Illinois State University Events Calendar Adding an Event To add an event to the Illinois State University Events Calendar, visit Events.IllinoisState.edu and scroll to the footer to login. Click the Copyright