Mercury Users Guide

Mercury Users Guide
Category
esembrat3 Fri, 02/22/2013 - 08:38
Drupal Version
Tags

This section provides an introduction to using the Georgia Tech Mercury (Hg) News and Events system.  None of the information in this section is Drupal specific - it's just being housed here for historic reasons.

If you are looking for information on how to install and manage the Mercury Hg Reader module, we have a separate section about Mercury Developers Guide.


Table of Contents

Getting Started with Mercury

Getting Started with Mercury
Category
afrank30 Tue, 12/30/2014 - 14:22
Drupal Version
Tags

First Step: Logging In

When you log in to Mercury for the first time, a Mercury user account will automatically be created for you.  The login link is on the upper left of the Mercury website at http://hg.gatech.edu/

Please note: The Mercury system is only available on-campus or while connected to the Georgia Tech VPN.

A group administrator cannot give you access to a group in Mercury until you have logged in for the first time.  So, if you expect to use Mercury and haven't ever logged in with your Georgia Tech account (e.g. gburdell1), please do so now.

Your Default Groups

As soon as you log in, you will become a member of two groups: Georgia Tech Events Calendar, and Hg Training.

The Georgia Tech Events Calendar group is a group in which all Mercury users are a member with the basic role of Author. Currently the main calendar on the Georgia Tech Web site is populated with any event created in Mercury that is in a published state, and part of the Georgia Tech Events Calendar group. This allows users to keep internally focused events on their own sites and only promote events open to the campus on the main calendar. Therefore, when entering events get in the habit of selecting the Georgia Tech Events Calendar group with your group selections if you want your event to appear on the main calendar. Note that you're also required to select one of your "home" groups.

The Hg Training group was set up for temporary training purposes. This group serves as a testing ground for helping users become familiar with generating Mercury content. However, any images, videos, or published content you add to this group will be viewable by others in the Mercury system.

Permission to Publish

In order to publish an event or news item in Mercury you must be a publisher of a group outside of the default groups. For most major campus units, there is already a group set up - consult the groups directory to request membership from the group's manager. If none of the existing groups apply to your needs, you can use the Group Request form to submit a request for a new group.

Once you have been set up within a group, your first step to enter content into Mercury is to select the appropriate group on the right-hand side of the page. Once your group is selected, you will be given numerous options to create content on the left-hand sidebar.

Groups, Users, and Roles in Mercury

Groups, Users, and Roles in Mercury
Category
afrank30 Tue, 08/04/2015 - 16:55
Drupal Version
Tags

About Mercury Groups

Groups serve as buckets for content, and are often associated with an academic unit or office. Separate groups for sub-units can be added as needed. For instance, a research center could have its own Mercury group separate from its parent school or interdisciplinary research institute.

However, the main purpose of groups is not to sort or categorize content, but to control who can edit (and delete) content.

Users are associated with groups and may have varying permissions within each group; it is possible to have different roles in different groups. All Mercury users are members of one or more groups (at a minimum, your major affiliation plus the Hg Training group).

Consult the groups directory to request membership from a group's manager. If none of the existing groups apply to your needs, please use the Group Request form to submit a request for a new group, or the Update Group information form to send correct managers for a group.

A tutorial is available for managing group memberships in Mercury.

About Mercury Roles

Each Mercury group has different sets of permissions for different users. Each permissions set is collected into a "Role", of which these are the main types:

  1. Author
  2. Publisher
  3. Manager
  4. Administrator

A tutorial is available for changing a user's Mercury role.

Author

Almost everyone you add to your group will have this role. An author can create content, but cannot make that content live (i.e. Publish it) and often cannot edit other people's content or feeds. This role is mainly useful if your group wants to:

  • have some users moderate content before it is made public,
  • allow people from other units to create draft content for your group, or 
  • allow people from other units to automatically add their events/news to your group/calendar.

Warning: if you make someone an Author in your group, they can publish your group's items if they are a Publisher in any other group.

Publisher

Publishers can create, edit, and publish content and feeds. They can also act as moderators for Author-created content.

Manager

There can be only one...manager of a group. Similar to being an "Owner" of a web hosting site, it allows Mercury support staff to know who is primarily responsible for a group. They have the same powers as an Administrator, but can also bulk remove or modify more than one user at a time using "Operations".

Administrator

This role can add new members to a group, and can allow people to become "Authors", "Publishers" or "Administrators" for a group.


Groups and Users Sub-Topics

Managing Group Memberships in Mercury

Managing Group Memberships in Mercury
Category
afrank30 Tue, 12/30/2014 - 14:30
Drupal Version
Tags

To add or remove a person, you must have the role of Administrator for that group.

Adding a Person

  1. On a Group page, find and select the Group tab at the top of the page (after the "View" tab).
  2. Select the "Add people" link.
    The shortcut to this link for any group is: http://edit.hg.gatech.edu/group/node/#/admin/people/add-user, where # is the group ID number.
  3. In the User name text box, type the name of the person you want to add.
    • If their name automatically appears as a drop-down after a few moments, select their name in that drop-down.
    • If not, the person needs to log in to Mercury, so that their account can then be found in the system.
  4. Check the boxes next to the Roles this person should have within your Group.
  5. Select the Add users button at the bottom of this page.
  6. If successful, you will see a message at the top of the page that says "[User Name] has been added to the group [Group Name]."
  7. You can return to the Group tab page by selecting the Group link in the breadcrumbs, after the name of this group.

Removing a Person

  1. On a Group page, find and select the Group tab at the top of the page (after the "View" tab).
  2. Select the "People" link.
    The shortcut to this link for any group is: http://edit.hg.gatech.edu/group/node/#/admin/people, where # is the group ID number.
  3. In the Name text box, type the name of the person you want to remove and select Apply.
    • If their name automatically appears as a drop-down after a few moments, select their name in that drop-down and then select the Apply button.
    • If not, you may have misspelled their name (or they may be a member under their GT Account, e.g. gburdell3).
  4. Find this person's account in the table at the bottom and select the Remove link in the farthest right column for their row.

    (Only the Manager of the Group can remove more than one user at a time using "Operations".)
  5. Select the Remove button on the next page.
  6. If successful, you will see a message at the top of the page that says "The membership was removed."

Changing a User's Role (Permissions) in Mercury

Changing a User's Role (Permissions) in Mercury
Category
afrank30 Tue, 08/04/2015 - 17:06
Drupal Version
Tags

To be able to change a person's Role (permissions), you must have the Role of Administrator for that group.

Changing a Person's Role

  1. On a Group page, find and select the Group tab at the top of the page (after the View tab).
  2. Select the People link.
    The shortcut to this link for any group is: http://edit.hg.gatech.edu/group/node/#/admin/people, where # is the group ID number.
  3. In the Name text box, type the name of the person whose role you want to change.
    • If their name automatically appears as a drop-down after a few moments, select their name in that drop-down and then select the Apply button.
    • If not, you may have misspelled their name (or they may be a member under their GT Account, e.g. gburdell3).
  4. Find this person's account in the table at the bottom and select the Edit link in the farthest right column for their row. (Only the Manager of the Group can modify more than one user at a time using "Operations".)
  5. On the next page, check or uncheck the boxes next to the Roles you want to add or remove.
  6. Select the Update membership button at the bottom.
  7. If successful, you will see a message at the top of the page that says "The membership has been updated."

How to Share Content Between Groups in Mercury

How to Share Content Between Groups in Mercury
Category
afrank30 Tue, 08/04/2015 - 18:22
Drupal Version
Tags

The Interface

At the bottom of most every type of content in Mercury, you will see a section called Groups audience, which will let you choose from a list of the Groups of which you are a member. You can select more than one Group by holding down the Command or Control button while clicking on each group's name.

Your current group (example: "School of Awesomeness") will automatically be chosen. As appropriate, you might also get permissions to share your content with other groups you belong to (perhaps an affiliated School or Department).

Don't Use Groups as Categories

One of the most basic ways you can sort your Mercury content is by using Groups. However, since the purpose of groups is to control who can edit (and delete) content, you will have more control over which items show on your website by using manual feeds and talking with your counterparts in other groups about news or events you would each like to share.

How to Safely Share Content with Other Mercury Groups

If you want to share content between groups, you need to contact the group manager and make sure you both have the same understanding of what kinds of news/events to share and when. This is especially important if:

  • A group is using automatic feeds, as any content you share may automatically be added to their calendar or list of news items.
  • One of you edits or deletes a piece of content that the other group needs.

Sharing Events with the Main Georgia Tech Calendar Site

To have your event show on the main Calendar site, check the box labeled Include this event on the Campus Calendar (within the Categories and Keywords section).

Canceled or Postponed Events

If an event is canceled or postponed, rather than deleting it from the system, add the word “CANCELED:” or “POSTPONED:” to the beginning of the event "Title". This will prevent broken links and confused users who may be looking for updated event information. Currently, events are never removed from the main Calendar site, so this also helps clarify their status on that website.

Sharing News with the Main Georgia Tech News or Research Horizons Sites

Institute Communications

First, contact an Institute Communications person from the Media Relations, Campus Communications, or the Research News teams. Tell them about story you have that you think would be great on one (or both) of these sites.

Categories

If research-related, check the box next to the most appropriate topic under "Core Research Areas".

If not research-related, let Institute Communications know which of these categories your story best matches: Business and Economic Development, Campus and Community, Earth and Environment, Health and Medicine, Science and Technology, or Society and Culture.

Create and Attach Media Files Correctly

In addition, it is especially important than any media on a news story for one of these sites be correct in its:

  • Aspect ratio: a 16 by 9 ratio is needed
  • Order of the first and second images: the first image listed is used as the Thumbnail or small image, while the second image chosen under "Media" is shown at the top of the full story page for this news item on those sites. The only exception to this is that any story with a video will automatically use the video instead at the top of the full story page.

Feeds in Mercury

Feeds in Mercury afrank30 Tue, 08/04/2015 - 16:45
Drupal Version
Tags

What is a Feed?

A feed is a list of content items from Mercury. Feeds let you organize any content from Mercury — your own and others' — and then display it on other web sites. The two most common types of content you will find in feeds are events and news.

Manual versus Automated Feeds

Content can be organized into two types of feeds in Mercury:

  • As an arbitrary Manual Feed, where you have complete control but must make every change yourself
  • Via a selection of rules in an Automated Feed that you set up once and don't have to touch again (unless you want to adjust those rules)

Examples of Automated Feed Usage

Commonly, people use relative dates, limit them to just one type of content (such as events only), and then connect these to hg_reader blocks and pages on their web site.

However, you can also use these to find related content, without connecting the feed to a website (thanks to Kathleen Moore for this idea!). For example, you could make an automated feed that helps you curate content you might add to a manual feed. It could search by keywords, or show content from other people's groups.

Examples of Manual Feed Usage

Commonly, people use this to control which news stories or events show up on the homepage of their website.

The only drawback to a manual feed is that nothing is added or removed from them, without someone's intervention.

Feed Readers

Readers allow your web site to pull in the feeds you create and display them on your site. Georgia Tech's Institute Communications offers a Drupal module, HG Reader, for getting this set up.

Feed Item Limits

As of the September/October 2017 Mercury refresh, all feeds can now contain a maximum of 200 items.

  • For an automated feed, any items beyond 200 items will not be displayed.  
  • For a manual feed, any new items beyond 200 will not be added.

Mercury Feeds Sub-Topics

Finding the ID for a Feed in Mercury

Finding the ID for a Feed in Mercury
Category
afrank30 Thu, 07/16/2015 - 12:03
Drupal Version
Tags

In Mercury, a feed ID is a five- or six-digit number that uniquely identifies a single feed (or list) within Mercury.

A feed ID is different from the ID for an individual news or event item.  Make certain you are getting an actual feed ID and not the ID for a single item within that feed.

Where to Find the Feed ID

First, you need to find a feed. Navigate into one of the groups you belong to in Mercury, and search the middle of the page for the "Group Feeds" section. Underneath it are listed any feeds already created for your group.

Select the Title of one of your fields listed in this table (for example, "Events: GT - Past 1 and future 6 months"). This takes you to the page for that feed.

The feed ID is the number shown in the URL (web address), after the phrase "node/", when viewing a feed in Mercury. For example, in the URL http://hg.gatech.edu/node/416041, the feed ID is "416041".

Using Another Group's Feed

If you want to use a feed from another group, all you need is this ID number and you can use that feed on your site, too! You are not required to have a Mercury account to include feeds on your site. If you do not have an account and wish to display an existing feed, contact the administrator of that group to get the feed ID number.

Creating an Automated Feed in Mercury

Creating an Automated Feed in Mercury afrank30 Tue, 12/30/2014 - 14:11
Drupal Version
Tags

Getting Started

  1. Log in to Mercury (at http://hg.gatech.edu).
  2. Select the link for your group (example: "Office of Something Awesome") in the column on the right side of the screen.
  3. Select the green Create automated link in the Feeds section of the left column.

Rule of Thumb

Tailor your feed output (using the options under Show items where...) to the smallest set necessary for your needs.  The more items you include, the harder Mercury has to work to assemble your feed, and the slower your website will get each time it connects to Mercury to get an update of your feed.

Consider limiting any archive feeds to no more than two years worth of news or events.  Chances are good that no one is really going to want to wade through anything more than that on your website.  If your unit's leadership wants to highlight specific news or events from an earlier time, just create a static "Historic Highlights" page and post the relevant information to that page so that interested site visitors can easily find it.

Create Your Feed Filter

NOTE: The filtering tools changed significantly after the September / October 2017 Mercury refresh.

  • For Item type is any of..., chose only those items types that you need.  A good practice is to create only single-type feeds (i.e. one feed for news, and a second feed for events).
  • For Group, choose the name of your group.  Otherwise, you'll be pulling items from every group in Mercury, which is never a good idea.
  • To limit items based on dates, use:
    • Event start for an events feeds
    • News dateline for a news feed
    Next, select a filter type:
    • after
    • on or after
    • before
    • on or before
    • between
    Next, enter your actual filter.  Below are some examples of commonly used filters:
    • now - the exact moment that the feed is being assembled
    • 2 months ago
    • 3 years ago
    • 2017-05-15 - A specific date in year-month-day format
    • For more possible date formats, please see the PHP Guide to Relative Date Formats
    As an example, 'News dateline' 'after' '1 year ago' will give you a feed of all news from the past year.

At any time, you can select APPLY FILTERS to see what Mercury items you get.  If you don't get anything, then either you set up a rule wrong, or there just isn't any content yet that matches those rules.  (It's always helpful to have a least one item in the system that matches the feed you are creating, just to act as a sanity check that you have your filter rules entered correctly.)

Feed Item Limits

As of the September/October 2017 Mercury refresh, all feeds can now contain a maximum of 200 items.

  • For an automated feed, any items beyond 200 items will not be displayed.  
  • For a manual feed, any new items beyond 200 will not be added.

    Creating a Manual Feed in Mercury

    Creating a Manual Feed in Mercury dgivens8 Fri, 09/23/2016 - 17:26
    Drupal Version
    Tags

    A manual feed is a feed which all items are pre-selected/approved. For more information, see the documentation on automated versus manual feeds.

    Getting Started

    1. Log in to Mercury (at http://hg.gatech.edu).
    2. Select the link for your group (example: "Office of Something Awesome") in the column on the right side of the screen.
    3. Select the green Create manual link in the Feeds section of the left column.

    Name Your Feed

    Title the feed something descriptive that will allow you and others to identify it through a search.

    Create Your Feed Filter

    NOTE: The filtering tools changed significantly after the September / October 2017 Mercury refresh.

    A feed filter for a Manual Feed is strictly to help you find content to add to your feed.  It will have no effect on your actual feed.

    The filter rule that appears by default is “Item type.” Once you’ve selected a type, you can then use the “Add a rule” drop-down menu to add additional filter rules such as “Core research area” or “Keyword.”

    Once you’ve finished adding the desired filtering rules, select the Apply Filters button and you’ll see the available news items below.

    Move Content Into the Feed

    The list of news items you’ve filtered out now appears on the left side of the screen under your filters. Once you’ve looked through the available items and picked the news titles you want to appear in your feed, drag them to the “Feed items” box on the right side of the screen.

    Don't forget to Save your changes before navigating off to another page.

    Categories and Keywords

    Categories and Keywords
    Category
    afrank30 Tue, 08/04/2015 - 17:39
    Drupal Version
    Tags

    Mercury provides a variety of ways to categorize and tag your content, and understanding their meanings will help you to utilize them effectively.

    Core Research Areas

    Georgia Tech has organized its research into core areas of special interest, and encourages you to tag News items with these areas in Mercury.  These research area tags are used to help find stories:

    • By those reading our news sites, such as the main NewsroomResearch Horizons, and Research (which pull almost all their news from Mercury)
    • By Institute Communications staff, to filter stories from our many brilliant units to feature on these central news sites
    • By individual units to highlight their news stories based on topic (using Feeds)

    List of Research Areas

    Georgia Tech has organized its research into the following core areas of special interest:

    • Bioengineering and Bioscience
    • Cybersecurity
    • Data Engineering and Science
    • Electronics and Nanotechnology
    • Energy and Sustainable Infrastructure
    • Manufacturing, Trade, and Logistics
    • Materials
    • National Security
    • People and Technology
    • Public Service, Leadership, and Policy
    • Renewable Bioproducts
    • Robotics
    • Systems

    Categories

    Category tags allow for easier sorting of content items.  Event category tags will help visitors browsing events on the main Georgia Tech Events Calendar to narrow down the list to those types of events they are most interested in attending.

    News, Image and Video Categories

    • Institute and Campus
      • Alumni
      • Arts @ Tech
        • Community
        • Education
        • Exhibitions
        • Performances
        • Art Research
        • Student Art
      • Congressional Testimony
      • Economic Development and Policy
      • Institute Leadership
      • Special Events and Guest Speakers
      • Student and Faculty
      • Student Research
    • Research
      • Aerospace
      • Architecture
      • Biotechnology, Health, Bioengineering, Genetics
      • Business
      • Cancer Research
      • Chemistry and Chemical Engineering
      • City Planning, Transportation, and Urban Growth
      • Computer Science/Information Technology and Security
      • Digital Media and Entertainment
      • Energy
      • Engineering
      • Environment
      • Life Sciences and Biology
      • Military Technology
      • Music and Music Technology
      • Nanotechnology and Nanoscience
      • Physics and Physical Sciences
      • Policy, Social Sciences, and Liberal Arts
      • Robotics 

    Event Categories

    • Arts and Performance
    • Career/Professional development
    • Conference/Symposium
    • Other/Miscellaneous
    • Seminar/Lecture/Colloquium
    • Sports/Athletics
    • Student sponsored
    • Training/Workshop

    Invited Audiences (for Events)

    This option lets you indicate who your event is aimed at. You can choose more than one audience, if you'd like, by holding down Control/Command while clicking on each audience.  Setting the invited audiences allows people to narrow down which events they might be interested in when browsing events on the main Georgia Tech Events Calendar.

    You can choose one or more of the following audiences:

    • Undergraduate Students
    • Graduate Students
    • Faculty/Staff
    • Public

    Keywords

    Keywords allow you to tag Mercury content for later sorting.  This can be helpful when you need additional categories that aren't included in the shared Categories already offered.  Keywords:

    • Are not generally displayed on central news or events sites, and are more often used for your unit's web site.
    • Must be spelled and capitalized identically in order to be used for sorting and filtering.
    • Are entered as a comma-separated list of terms describing the item, e.g. "aircraft" or "5th street."
    • Should be kept as short and as plentiful as possible
    • Should not be a repeat of the item title.

    Adding a News Item to Mercury

    Adding a News Item to Mercury
    Category
    afrank30 Tue, 12/30/2014 - 16:23
    Drupal Version
    Tags

    Preparatory Steps

    Log In and Choose Your Group

    After logging in to Mercury, your first step to enter content is to select the appropriate group on the right-hand side of the Mercury site.

    Select the main group to which this content is relevant.

    Once your group is selected, you will be given numerous options to create content on the left-hand sidebar:

    Add Media (Optional)

    If your news item will include any images or videos, you have to upload those first, before adding a news item. Learn how to upload an image or upload a video to Mercury. 

    Beware of Copy and Paste!

    Microsoft Word and some other applications use several characters that do not work well on the Web. Common examples are ampersands (&), angled quotes (single and double) and long dashes (en and em dashes).

    For most long fields in Mercury, you can get around the vast majority of these issues by clicking on the paste from word button. However, this button is not available for short text fields without an Editor Toolbar (particularly of note: Title, subtitle, summary sentence and any field that might contain a name with apostrophes. If you cut and paste from Word into these fields, you may want to re-type any punctuation from the pasted text as a precaution. Another approach is to put your text into a plain text program first (Notepad for PC or Text Edit for Mac) and copy and paste into Mercury from there.

    Sharing With Georgia Tech News and Research Publications

    Please see the guidelines for sharing news with the main Georgia Tech News Site or the Research Horizons Site if you are preparing this news item to be shared with either group.

    Create Your News Item

    From the left-hand sidebar, select Create News or Create External News

    Required Fields

    Title

    Your news item might be shown in places other than your website. So, choose a Title that:

    • clearly explains what your news item is about to a general audience (try to highlight the most important thing about it).
    • is self-explanatory even when not on YOUR website.
    • is concise, around eight words, so it doesn’t run over when feeding into other places across various websites.
    • has a catchy or informative headline that will inspire the reader to actually read your news story. 
    • you will not need to change, as changing the title cause duplicates on the news site or break links to this story.

    Summary Sentence

    • Provide information that adds to the information already given in the Title, and use only 10 to 12 words at most.
    • This will show up on gatech.edu's GT News feed (if you share with their group).
    • This often displays below the headline, so don’t be repetitive.

    Dateline/Location

    These fields auto-populate with today’s date and Atlanta, GA — in most cases, leave as is.

    Contact

    If someone has questions, who can answer them? Or, who’s the author? 

    Include that person’s name, email address, and phone number.

    Groups

    If you want this article to show up in multiple places, select all the relevant groups.

    The news sites where this item will show up. Your group (example: "Office of Awesome") will automatically be chosen. As appropriate, you might also get permissions to share your news item with other groups (perhaps an affiliated School or Department). This allows you to syndicate the content to other sites.

    Default Workflow

    Change the workflow from “Draft” to “Published” so that your item shows up in news feeds.

    Unless you’re not finished, in which case, save as a Draft to come back to publish it later.

    Recommended Fields

    Body

    You can give a fuller description of the news item here. It can have lots of details, and multiple paragraphs are allowed. Avoid leaving the Body section blank. 

    This section should provide information about the news item itself, such as whether it’s part of a series, activities that will take place at the news item, or context of why a speaker is relevant to campus. If you are copying and pasting text, refer to the “Beware copy and paste” note above. Hyperlink websites in your text (e.g., if your text reads “clough.gatech.edu,” make sure that text is clickable). For longer URLs, hyperlink words to the website so the URL is not messy within the news item link (e.g., for a long application link, use the words “Apply online,” and hyperlink those words to the application URL). Be as specific as possible, but know that you can link to other pages for more information (such as agendas, directions, or speaker bios).

    Related Links

    Drop this area down and include any relevant websites — perhaps any organizations/Schools/Units associated with the story. 

    Repeat important links from the Body section here to make sure readers can find the information.

    Category

    The goal of these tags is to make your news item easier to find on OTHER news sites (especially the very large Newsroom site). Choose the category that best fits your news item. To select multiple categories, hold down the “Control” (ctrl) key while clicking each applicable category.

    Keywords

    These help your news item be associated with others that are about the same thing, and it also can be used to feed websites. Make sure you spell words correctly, place commas correctly, and try to use keywords that auto-populate as you type so you’re not creating too many new ones.

    Commas will separate each keyword, so some things may need to be altered to work as keywords (e.g., “School of Literature, Media and Culture” should be entered without commas, or else it will be processed as “School of Literature” and “Media and Culture.”)

    Core Research Areas

    If your news applies to one of the Core Research Areas, check the corresponding boxes accordingly. Your selections here should match those in the “Category" and "Keywords” sections. 

    Optional Fields

    Summary

    This appears in the news feed the day your news item occurs. Your summary should be one to two sentences in length, and can expand a bit from the Summary Sentence.

    You may also use the same copy from the Summary Sentence — these two never show up at the same time. Be aware that this does not fill the main body space on the news item listing itself; the Body field will do that.

    Subtitle

    Give a little more detail than what's in the Title, and do not repeat the Title.

    Media

    Type in the title of any image or video you have previously uploaded associated with this listing. Results will populate as you begin to type.

    File attachments

    This is an opportunity to attach files that do not fit into the image or video category, such as a PDF application, guidelines, or reports. However, this requires the user to download a file to be able to view it (unlike photos or videos items), so make sure anything you’re attaching here is worth the user’s time to download. News item flyers are generally better included as images rather than attachments.

    Adding an Event to Mercury

    Adding an Event to Mercury
    Category
    afrank30 Tue, 12/30/2014 - 15:49
    Drupal Version
    Tags

    Preparatory Steps

    Log In and Choose Your Group

    After logging in to Mercury, your first step to enter content is to select the appropriate group on the right-hand side of the Mercury site.

    Select the main group to which this content is relevant.

    Once your group is selected, you will be given numerous options to create content on the left-hand sidebar:

    Add Media (Optional)

    If your news item will include any images or videos, you have to upload those first, before adding a new event. Learn how to upload an image or upload a video to Mercury. 

    Beware of Copy and Paste!

    Microsoft Word and some other applications use several characters that do not work well on the Web. Common examples are ampersands (&), angled quotes (single and double) and long dashes (en and em dashes).

    For most long fields in Mercury, you can get around the vast majority of these issues by selecting the paste from word button. However, this button is not available for short text fields without an Editor Toolbar (particularly of note: Title, subtitle, summary sentence and any field that might contain a name with apostrophes. If you cut and paste from Word into these fields, you may want to re-type any punctuation from the pasted text as a precaution. Another approach is to put your text into a plain text program first (Notepad for PC or Text Edit for Mac) and copy and paste into Mercury from there.

    Create Your Event

    From the left-hand sidebar, select Create News or Create External News

    Required Fields

    Title

    Your event might be shown in places other than your website. So, choose a Title that:
    • clearly explains what your event or news item is about to a general audience (try to highlight the most important thing about the event).
    • is self-explanatory even when not on YOUR website.
    • is concise, around eight words, so it doesn’t run over when feeding into other places across various websites.
    Canceled or Postponed Event Titles

    If an event is canceled or postponed, rather than deleting it from the system, add the word “CANCELED:” or “POSTPONED:” to the beginning of the event "Title". This will prevent broken links and confused users who may be looking for updated event information. Currently, events are never removed from the main Calendar site, so this also helps clarify their status on that website.

    Summary Sentence

    • Give information that adds to the information already given in the Title, and use only 10 to 12 words at most.
    • This will show up on gatech.edu's GT Events Calendar or News feed (if you share with their group).

    Location

    You only need to enter information into the FIRST box. Type at least the Building and Room Number but, for events with an off-campus audience, consider adding the Full Address in case they need directions.

    Contact

    This is very helpful for your audience if they have questions, especially when your event is shown on OTHER CALENDARS (i.e. not yours). Include a specific name, department, email, and phone number.

    Invited Audience

    • Choose the audience for which this event is intended: the public, students, faculty/staff.
    • You can choose more than one audience, if you'd like, by holding down Control/Command while clicking on each audience.

    Event Category

    The goal of these tags is to make your event easier to find on OTHER calendars (especially the very large GT Events Calendar).

    There’s a checkbox labeled "Include this event on the Campus Calendar” (within the Categories and Keywords section). Including events on the campus calendar is as simple as checking this box. To exclude them from the campus calendar, leave the box unchecked.

    Groups

    The calendars where this event will show up. Your group (example: "Office of Awesome") will automatically be chosen. As appropriate, you might also get permissions to share your event or news item with other groups you belong to. This allows you to syndicate the content to other sites. Be sure to check with the managers in that group to clarify whether they want you to do this for their group, as their may be an approval process they would prefer.

    Default Workflow

    Choose "Published" or your item stays hidden and will not show up on any calendars or news feeds. Once published, anyone in the Mercury system can find your event and add it to their manual feeds.

    The Draft option is there for times when you need to save incomplete work and come back to it later, or to show to others before making it live.

    Event Time

    A calendar will pop up and allow you to select the Date, but you must type in the Time.

    Specify a From and To date/time for your event. The To date is not required, but to make your entry as useful as possible, please include a To date with an ending time if your event takes place during a specific time. Be sure to indicate AM/PM. You can check the box, if relevant, for an “All Day” event.

    Repeat

    These options will be useful if your event takes place over a series of days or several times in a specified time frame. A couple of examples:

    • An event happening over multiple days: If you have a three-day seminar that occurs February 1 - 3 from 9:00 a.m. to 4 p.m., you would select February 1 for the From date and 9:00 AM for the time. For the To date, you would also select February 1, but 4:00 PM for the time. Under the Repeat options, select “Every” in the Frequency drop-down menu and “Days” in the Period drop-down menu. In the Until field, you would select the day after the last date of the seminar: February 4. This will make your event repeat in the calendar each day through February 3.
    • An event occurring at a regular interval each week/month: Perhaps you have a recurring event that takes place on a specific day of the month, such as the second Monday or last Friday. You can find those options under the Advanced section of the Repeat options. Example: If a lecture series occurs on the second Monday of the month throughout the semester, you would enter the first time it occurs in the From and To fields, then select “Every” in the Frequency drop-down menu and “Months” in the Period drop-down menu. In the Until field, you would enter a date after the last lecture takes place, but before the second Monday of the next month. Then, in the Advanced options, select “Second Monday” under the Day of Week list. This will list your event in the calendar on the second Monday of the month within the range you selected. You can also add or exclude dates from a series. Say your March lecture is postponed a week; you can add the date for the March event in the field under the Except options, and provide the date it is rescheduled in the field under the Additional options.
    Repeat vs. Individual events (and Copying)

    One thing to note about using the Repeat options versus entering individual events for an ongoing series is that if you use Repeat, the event title will be the same every time it shows up in the calendar. When entering an event like the lecture series example, you may prefer to have a speaker’s name or subject in the title for each occurrence so that more details are available upon viewing the title. If this is the case, you will need to forego using the Repeat options and instead enter a separate event for each occurrence of the lecture series.

    If you want to make multiple copies of a similar event, you can use the "Clone" tab to make a nearly exact copy of an event, and then just update a few of the details.

    Optional Fields

    Summary

    This appears in the calendar feed the day your event occurs. Your summary should be one to two sentences in length, and can offer details not found in the Title or Summary Sentence.

    You may also use the same copy from the Summary Sentence — these two never show up at the same time. No need to include the date, time, or location here, as they have their own places. Be aware that this does not fill the main body space on the event listing itself; the Body field will do that.

    Body

    You can give a fuller description of the event here. It can have lots of details, such as times, agendas, etc. Multiple paragraphs are allowed.

    This section should provide information about the event itself, such as whether it’s part of a series, activities that will take place at the event, or context of why a speaker is relevant to campus. Avoid leaving the Body section blank. If you are copying and pasting text, refer to the “Text” note about using the "Paste from Word" button. Read through your text for duplicate information you’ve already specified, such as the date, time, and location, and delete those pieces. Hyperlink websites in your text (e.g., if your text reads “clough.gatech.edu,” make sure that text is selectable). For longer URLs, hyperlink words to the website so the URL is not messy within the event link (e.g., for a long application link, use the words “Apply online,” and hyperlink those words to the application URL). Be as specific as possible, but know that you can link to other pages for more information (such as agendas, directions, or speaker bios).

    More Location details

    You may specify phone number, URL, or email if you choose. 

    If your event is open to the public or at a location to which attendees may need a map, you can also reference map.gatech.edu. Select the name of your chosen building, then select the share link on the pop-up to get a direct link to that building on the map. (Tip: If you have trouble finding the share link for a building on the map site, check if your web browser is using any Ad blockers.)

    Related Links

    Select the arrow to expand this section. Include any relevant links, such as speaker bios, school or college websites, registration or application pages, or other links for more information. Repeat links from the Body section here to make sure readers can find the information.

    Keywords

    Begin typing relevant keywords here to see what has already been used. When possible, use the same phrasing, wording, capitalization and spacing as keywords that appear while typing, so that related events can be grouped together. Commas will separate each keyword, so some things may need to be altered to work as keywords (e.g., “School of Literature, Media and Culture” should be entered without commas, or else it will be processed as “School of Literature” and “Media and Culture.”)

    Media

    Type in the title of any image or video you have previously uploaded associated with this listing. Results will populate as you begin to type, with media from your group showing towards the top of this list.

    File attachments

    This is an opportunity to attach files that do not fit into the image or video category, such as a PDF application, guidelines, or reports. However, this requires the user to download a file to be able to view it (unlike photos or videos items), so make sure anything you’re attaching here is worth the user’s time to download. Event flyers are generally better included as images rather than attachments.

    Adding an Image to Mercury

    Adding an Image to Mercury
    Category
    afrank30 Tue, 12/30/2014 - 15:58
    Drupal Version
    Tags

    Step by Step Instructions

    1. First, edit the image, if needed, on your computer. Best practices for images are:
      • If large, consider re-sizing your image to exactly the size that will look good on the desktop version of your site.
      • Use a consistent aspect ratio for your images: we recommend a ratio of 16 by 9, unless your image will only be for headshots or for Hg Reader thumbnails, which use a square 1:1 ratio.
      • Choose a good name for your image (all lower case, use hyphens instead of spaces, avoid punctuation, short but descriptive).
      • Make sure your filename ends in either .jpg, .jpeg, .png, or .gif (all lower case).
    2. Select Create Image on the left side, and follow these instructions:
    3. Provide a basic title for the image, which will appear next to the photo once the event is posted.
    4. Select Browse or Choose File and find the image that you would like to include, then select Upload
    5. Select any appropriate categories from the list and enter any keywords for the image.
    6. Choose the appropriate group(s) in the Groups audience field.
    7. Select Save

    Image Naming for Ease of Access

    You can make it easier to find images in Mercury by using a simple pattern for the Title field, such as:

    • Organization name or abbreviation: Clough
    • Significant subprogram or subcategory for your organization: Art Crawl, or Students
    • Date image was created or uploaded: 2013
    • Short phrase describing image (1-4 words): Winners in photography

    In this example, your title for this image would be: "Clough Art Crawl 2013 - Winners in photography"

    Remember that this title field will be visible to the public, either as an image caption on some News sites or as alternative text for screen readers.

    Where to Add Images for News/Events

    On both the Create Event and Create News pages, you can add Images under the section called Media.

    To attach individual images, start typing the title of an image you've created into one of these Media fields.

    Adding a Video to Mercury

    Adding a Video to Mercury
    Category
    afrank30 Tue, 12/30/2014 - 16:02
    Drupal Version
    Tags

    Overview of Steps

    1. Upload your video to YouTube and add accessible captions.
    2. Choose a good name for your video.
    3. Select Create Video on the left side and follow these instructions:
    4. Enter a title for the video, which will appear next to the video within a news or event item.
    5. Enter the ID for the video in the YouTube ID field.
      • The ID can be found by clicking on the “Share” link below the display of your video on Youtube.com. The series of text and/or numbers after “http://youtu.be” is the ID. For example, in the YouTube Share link “http:// youtu.be/123XYZ,” the video ID would be “123XYZ.”
    6. Select any appropriate categories from the list and enter any keywords for the video.
    7. Choose the appropriate group(s) in the Groups audience field.
    8. Select Save.

    Video Naming for Ease of Access

    Make it easier to find videos when trying to add them to news items. Use a simple pattern for the Title field, such as:

    • Organization name or abbreviation: Clough
    • Significant subprogram or subcategory for your organization: Art Crawl or Students
    • Date image was created or uploaded: 2013
    • Short phrase describing image (1-4 words): Winners in photography

    In this example, your title for this video would be: "Clough Art Crawl 2013 - Winners in photography."

    Where to Add Videos for News/Events

    On both the Create Event and Create News pages, you can add videos under the section called Media.

    To attach individual videos, start typing the title of a video you've created into one of these Media fields.

    Tips and Tricks for Mercury

    Tips and Tricks for Mercury
    Category
    afrank30 Tue, 08/04/2015 - 17:17
    Drupal Version
    Tags

    This section is for tips and tricks to making Mercury easier to use.  Feel free to add to this section any tips or tricks you've discovered.


    Tips and Tricks Sub-Topics

    Quick Guide to Fields in Mercury Events and News

    Quick Guide to Fields in Mercury Events and News
    Category
    ab89 Mon, 01/28/2013 - 09:59
    Drupal Version
    Tags

    This page highlights the main fields (boxes to type text into) that need to be completed for each type of content in Mercury. The OUTLINE for this page is below:

    Always-required Fields for Both Events and News

    These are the fields you will ALWAYS have to enter for EVERY type of information (news, event) you put into Mercury:

    Title

    Your event, news item, or image might be shown in places other than your website. So, choose a Title that:

    • clearly explains what your event or news item is about.
    • is self-explanatory even when not on YOUR website.

    Summary Sentence

    • Provide information that adds to the information already given in the Title, and use only 10 to 12 words at most.
    • This will show up on the Georgia Tech Events Calendar or News feed (if you share with their group).

    Groups

    The calendars and news feeds where this information will show up. Your group (example: "Clough Commons") will automatically be chosen. As appropriate, you might also get permissions to share your event or news item with other groups you belong to (perhaps an affiliated School or Department).

    Default Workflow

    Choose "Published" or your item stays hidden and will not show up on any calendars or news feeds.

    Required Fields for Events

    Below are the additional required fields you should fill in for each event.

    Event Time

    A calendar will pop up and allow you to choose the Date, but you must type in the Time.

    Invited Audience

    • Choose whether your events is for: the public, students, faculty/staff.
    • You can choose more than one audience, if you'd like, by holding down Control/Command while clicking on each audience.

    Event Category

    The goal of these tags is to make your event easier to find on OTHER calendars (especially the very large GT Events Calendar).

    There’s a checkbox labeled "Include this event on the Campus Calendar” (within the Categories and Keywords fieldset). Including events on the campus calendar is as simple as checking this box. To exclude them from the campus calendar, leave the box unchecked.

    Optional Fields for Events

    It is not required, but it is highly recommended that you also fill in these other fields for events:

    Location

    You only need to enter information into the FIRST box. Type at least the Building and Room Number but, for events with an off-campus audience, consider adding the Full Address in case they need directions.

    Contact

    This is very helpful for your audience if they have questions, especially when your event is shown on OTHER CALENDARS (i.e. not yours).

    Body

    You can give a fuller description of the event here. It can have lots of details, times, agendas, etc. Multiple paragraphs are allowed.

    Optional Fields for News

    To best publicize a news item when you share it, especially on the GT Events Calendar/News feed, it is highly recommended that you also fill in these other fields:

    Category and Core Research Area(s)

    These tags help people (including Institute Communications) sort through the HUGE number of news items to find topics of most interest to them.

    Body

    This is where the text of your news article goes. Without it, your news article will just be a title and summary sentence.

    Fields for Images

    If you plan to use an image with your event or news item, create it FIRST, before creating said event/news.

    Title

    Make it easier to find images when trying to add them to news items. Use a simple pattern for the Title field, such as:

    • Organization name or abbreviation: Clough
    • Significant subProgram or subcategory for your organization: Art Crawl or Students
    • Date image was created or uploaded: 2013
    • Short phrase describing image (1-4 words): Winners in photography

    In this example, your title for this image would be: "Clough Art Crawl 2013 - Winners in photography."

    Image (Browse / Choose File)

    Upload the file for your image or picture.

    Where to Add Images for News/Events

    On both the "Create Event" and "Create News" pages, you can add images under the section called "Media."

    Start typing the Title of images you've created into these fields to attach individual images.

    Cloning Mercury Content

    Cloning Mercury Content
    Category
    afrank30 Thu, 12/15/2016 - 11:03
    Drupal Version
    Tags

    If an article you want to re-share is already in Mercury, it is recommended that you simply locate it and add it to one of your feeds.  However, sometimes you may need to duplicate that item, such as if the focus of the piece needs to be changed to work for your own unit's website.Image removed.

    Copying or Cloning Content

    1. Select the Clone Content tab at the top of an item's page in the Mercury system (http://hg.gatech.edu/)
    2. Change the Title field to remove the text "Clone of"
    3. Make sure the correct group is chosen under Groups audience
    4. At the bottom, change Workflow to Draft
    5. Select Save (but only after taking the above steps first).