Table of Contents
Data Management Admin Tool
Use the data management tool to add, edit, and delete all available UPMC newsletters.
Access to the Flying Cork x UPMC back end data management tool is currently granted via email.
Manage Available Newsletters
Visit the data management tool (via the access URL provided in an email) and navigate to Manage Newsletters and Categories > Available Newsletters.
The file below creates the functionality to add, edit, delete, and display all available newsletters within the back end data management tool. Data manually populated into the back end then gets pulled into the front end of the UPMC Dynamic Preference Center.
- File path: UPMC BU > My Landing Pages > Profile Center > Dynamic Preference center > Back End > AJAX Manage Preference Subscriptions - Edit Landing Page
The data from this section gets recorded in a data extension called Available_Subscriptions, located here:
Add Newsletter
Click “Add Newsletter” to add a new newsletter. If the newsletter has an “active” status, these additions will immediately be reflected in the preference center.
- Newsletter Title: The title of the newsletter. This should be a "friendly name" as it will be visually displayed in the preference center. This is a "read only" field meaning it cannot be edited later.
- Description: The description of the newsletter. This should be a "friendly description" as it will be visually displayed in the preference center. This should be no longer than 110 characters.
- Small Thumbnail Img URL: The URL of the small thumbnail image. Image is provided by the client and dimensions should be 100x100. Upload the image into content builder and paste the URL into this field. If an image is not provided, use this placeholder: https://image.notify.upmc.com/lib/fe9213727564007a7c/m/3/8c63266e-acc2-4498-86af-5449c155ef20.gif.
- Large Thumbnail Img URL: The URL of the large thumbnail image. Image is provided by the client and dimensions should be 510x292. Upload the image into content builder and paste the URL into this field. If an image is not provided, use this placeholder: https://image.notify.upmc.com/lib/fe9213727564007a7c/m/3/7bfa687b-11e3-4b1c-85f7-5adf5c9e9ba0.gif.
- Is Static: Indicates static vs dynamic newsletter. Enter "true" if static and "false" if dynamic. For more information on static newsletters, click here. For more information on dynamic newsletters, click here.
- Active Newsletter: Indicates active vs inactive newsletter. Enter "true" if active and "false" if inactive.
- Data Extension Name: The data extension in which the newsletter is associated with.
- Parent Data Extension Name: The parent data extension in which the newsletters' data extension is a child of. Click here for more information.
- Auto Subscribe Once: Indicates whether or not a newsletter constitutes as "auto subscribe once." Enter "true" or "false."
- Priority: The priority/sort order of the newsletter. This functionality is not currently being utilized. Leave the field blank for now.
Edit/Delete Newsletter
Click the “Edit” button to the right of the newsletter to make changes to that particular newsletter.
When newsletter data is edited using the data management tool, the record in the Available_Subscriptions data extension will also be updated, and changes are immediately reflected in the preference center.
Click the “Delete” button to the right of the newsletter to delete it.
When newsletter data is deleted using the data management tool, the record in the Available_Subscriptions data extension will also be deleted, and the newsletter will no longer be available in the preference center.
Featured Newsletters
Click here for information on featured newsletters.
Pair A Newsletter With A Category
Click here for information on pairing newsletters with categories.
Preference Center Interface
On Page Load
Initialize/Populate Subscriptions
sortByTitle(). Once the newsletters are sorted, we call the
initializeSubscriptions()function, and we loop through the de_title_pairs object to populate the page with the newsletters’ DOM objects
Filtering Newsletters
We run the filterNewsletters() function onChange, which will:
- Create a new array, called divsToHide, containing all of the newsletter DOM objects
- Grab the value (which would be the category) from the dropdown
- Set all newsletters to display none, then loop back through the divsToHide array and set any newsletters matching the category pulled from the dropdown to display inline block.
Relevant Functions
sortByTitle(array)We have to use a bubble sort to alphabatize all the data extensions and publication lists because Internet Explorer doesn’t allow us to make use of the .sort() function.
initializeSubscriptions()This is the core function that populates the page on load. We use the
sortByTitle()
function to alphabatize the array of objects, de_title_pairs. Once sorted we loop through the array and call the
AddToMySubscriptions(),
AddToFeaturedSubscriptions(), and
AddToAllSubscriptions()functions passing the DE name / publication list ID
AddToAllSubscriptions(deName)Creates a DOM object in the All Subscriptions section and adds an event listener to the toggle switch. If the current deName passed into the function matches the first_position_de it will add a DOM object in the all-first-position div.
AddToMySubscriptions(deName)Creates a DOM object in the My Subscriptions section and adds an event listener to the toggle switch. If the current deName passed into the function matches the first_position_de it will add a DOM object in the my-first-position div.
The data extension name is passed in as deName and we use that to look up the title, description, image url, etc. in the PreferenceCenterData.DataExtensions object.
AddToFeaturedSubscriptions(deName)Creates a DOM object in the Featured Subscriptions section and adds an event listener to the toggle switch.
The data extension name is passed in as deName and we use that to look up the title, description, image url, etc. in the PreferenceCenterData.DataExtensions object.