OU Mashup V2
OU Mashup v2 is the new iteration of OU Mashup. All instances of OU Mashup implemented in 2018 and onwards are v2. Its main advantages include:
- The ability to add multiple accounts per social media type
- Faster load times and less strain on resources
- Integration with tag management and OU Blogs
OU Mashup v2 supports the following social media types:
- OU Blogs
The display page is a regular interior page, located within the /social folder off the root of your site. It will be named either default.pcf or index.pcf and uses the same styling as the rest of your site.
Note that this page will not display when viewed on staging in OU Campus - to see how the page looks, view it on production. It contains no editable regions. The display page can have its theme changed via a separate _settings.pcf page.
The rest of the files for the module are located in /_resources/social. The following folders will be consistent across all implementations:
- cache: contains files that instruct the module how to cache the posts it loads in, if a caching method is being used.
- credentials: contains a .pcf for each social media account connected to OU Mashup, as well as a general _settings file. Additional .pcfs can be created to connect more accounts, and the existing .pcfs can be modified.
- images: contains all images used by the module, including the various social media icons.
- themes: contains the css files and html templates that style the display page according to each theme.
- xsl: contains files that style the pages used to edit OU Mashup, such as the credentials and settings pages. This does not effect the display page.
In addition, there will be folders containing code that will depend on the programming language of your production server (e.g. php, aspx).
The credentials pages are where you connect your social media accounts to OU Mashup. Each account gets its own credentials page. The module comes pre-loaded with one credential page for each type of social media (e.g. Facebook, Instagram), but more can be created by clicking the +New button at the top of the pages list view.
Editing credentials pages is done via Page Properties > Parameters (as a reminder, a page must be checked out to edit the parameters). There are two sections of the page parameters.
The first is Title and Metadata. This contains one field for tags. When a credentials page is tagged, all posts from the associated social media account will have that tag attached in OU Campus. Then these posts can be filtered on the display page via the dropdown. An account can have more than one tag associated, and a tag can be used for multiple accounts.
All tags must start with "oumashup_" to be used for filtering.
The second section is Custom Settings. The settings are:
- Display: Check this to show posts from this account on the display page.
- Count: Determines the number of posts from this account shown on the display page at a given time
- Account Verification: These fields will be different for each type of social media account. Fill them out with the appropriate information to connect the social media account to OU Mashup.
When previewing a page, you will see a summary of the custom settings. You can also click "Developer Debug (For Advanced Users)" to see a JSON view of the data being returned by the API. You can use this to determine if the entered credentails are valid; if not, the error message will be returned under the field "caption."
Credentials pages do not need to be published. For changes made to credentails pages to take effect, republish _settings.pcf.
The _settings.pcf page in the credentials folder controls settings that affect all social media accounts linked to OU Mashup. This is also edited via Page Properties > Parameters. The settings that can be modified are:
- Title and Metadata: Tags can be entered, though they will only affect internal OU Campus filtering, not the display page.
- Icons: OU Mashup uses images loaded into OU Campus for the social media icons. When implemented, OU Mashup comes with these images
already uploaded into the appropriate folders in /_resources/social/images/. Selecting an image directs OU Mashup to look in that location for all other images
for that category (filter or feed).
- Feed icons are those used to label individual posts on the display page.
- Filter icons are those used at the top of the display page to filter the posts being shown.
- Theme and Handler: Select a theme for the display page. OU Mashup comes with four themes: Default, Default Flipped, Light, and Dark. Custom themes can also be configured by your institution. The web handler, aka the location the browser requests for data, is also configured here.
- Caching Configuration: Select the type of caching you would like OU Mashup to use, as well as how long
the cache will last (for certain types). By using caching, OU Mashup can store posts
to display for a certain amount of time instead of loading them from scratch every
time the page is refreshed.
- C# Caching: caches posts in system memory for the set amount of time, and creates a backup cache.
- PHP Caching: stores the social media posts data structure in a .cache file.
- PHP Cron: Requires a cron configuration to work and is recommended for advanced users only.
- Scheduled Publish: Recommended if and only if no other options work. The XSL calls the scripts and generates a static JSON file as a .pcf. This JSON pcf file will need to be set on a recurring publish schedule.
- No Caching: No caching is enabled.
- Filter Configuration: Choose whether to show the filter icons and the tag filter dropdown on the display page.
Adding New Social Media Accounts
Adding a new social media account is done by adding a new credential page and filling out the appropriate information:
- Navigate to _resources/social/credentials.
- Select green the +New button at the top of the page.
- Choose the type of social media account you would like to add.
- Give the file a name; make sure it is a different name from existing credentials pages. For example, if you already have a facebook.pcf, this page might be arts-facebook.pcf.
- Fill out the appropriate account information, such as AppID.
- Select the number of items to be shown on the display page.
- Click Create.
- Once created, the page does not need to be published. Instead, republish the _settings.pcf file to add the new account to the display.