In mid January 2014, the main CS Dept. website was re-launched on Drupal, an open-source content management system widely adopted by the University. Standard content pages can now be added and edited through admin interface without having to go through the web developers. Additionally, some content types are no longer managed through ADM and instead are managed through the new website.
Logging In
Prior to logging in an account with proper privileges must be created for you by a member of the development staff. After an account has been created, you can login by going to http://www.cs.princeton.edu/login. Click the button "Log In", which will attempt to authenticate your account via CAS. You do not need to maintain separate credentials for the website.
After logging in, you'll be redirected back to the homepage. You should now have a black horizontal bar at the top of the page. If you don't see this bar, then you are probably not logged into the website. If you want to log out for whatever reason, there is a "Log Out" link on the right.
Adding New Content
Content on the site is broken up into several different "types":
- Event - Department events. This used to be managed in ADM.
- News - Department news. This used to be managed in ADM.
- Page - A standard page containing any other type of content. Pages typically added in the menu somewhere.
- Job Listing - Job listings are nearly identical to pages, but should only be used to manage job listings for the department.
- Gallery Image - These are the images that are randomly displayed on the homepage and viewable in the gallery.
To add content, hover over "Content" -> "Add Content" on the admin bar and click the link for the appropriate content type. This brings you to an admin page where you can fill in the details for the content. On the left are organizational tabs. Click through them to expose different form fields. Fields that are required are marked with an asterisk.
Menu settings
For "Page" content, you have the option to add the page to the Menu. This is recommended for most pages. When you click the "Provide a menu link" checkbox, additional fields appear. You should specify the Menu link title (the name of the page as it appears in the menu) as well as the Parent item. You can also specify a numerical weight for the page, which determines the position of the item relative to other items with the same parent page. However, an easier way to manage the order of menu links is by going to the menu page directly (more on that below).
URL path settings
All pages need a path that is used to access them. All content types except "Page" will have this populated automatically based on the title of the content. For Page content types, you'll need to enter the path manually. The path you enter is typically dependant on where the page will be in the menu. For instance, if you're adding a page to the Academics menu, and your page title is "Here is my new page", you'll enter a path like "academics/here-is-my-new-page".
Revisioning information
When you edit an existing page, a revision is automatically created. This allows us to revert back to the old page if needed and keep track of what has changed over time. There is a section to enter a "Revision log message", which will help staff identify the purpose of the changes. Using a revision log message is recommended.
Publishing information
When new content is added, it will not be published automatically. That means that only privileged users can view the page, and it's not viewable to "anonymous" visitors. Admins will be notified when new content is added, and they can review it and publish it to the main site. Content that is already published does not go through an approval process at the moment.
Managing Existing Content
The admin screen for editing content is nearly identical to the screen for adding new content. All the same form fields are there, but they will be populated for existing content and can be modified. To get to the edit pages, there are two different approaches:
Through the content listing page
On the black admin bar, click the "Content" link. This will bring you to an admin page that lists all of the editable pages on the website. You can filter the data by things like Title and content Type (Event, News, Page, etc). The table is also sortable - meaning you can click the column headers to sort by that column.
Clicking the page title will bring you to the page. However, you can edit and delete the pages usin the links on the right.
Via the "Edit" tab
When viewing a page that is editable, there will be an "Edit" tab on the page. Click this to go to the backend edit interface for the page.
Managing the Menu
As stated above, you can add "Page" type content to the menu system which is recommended. The main menu (shown in the orange bar on the site) shows two levels of heirarchy. If you add items to the third level, they will not appear in the menu bar. However, adding items to the menu in this fashion is encouraged, since the breadcrumb system relies on the menu structure to provide users a proper context to where they are on the website.
The intial adding of a page to the meny can be done by editing the page and clicking the group for Menu Settings. Beyond that, you can see an overview of the entire menu structure as well.
Browse to "Structure" -> "Menus" -> "Main Menu" in the admin toolbar. A visualization of the menu appears. You can grab the arrow handles on the left of each item and re-arrange the menu items as you see fit. Please use caution when doing this, since many pages have their URL's set to minic their current menu placement. This screen is typically used to re-order menu items relative to one another.