Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Status

...

Status
colourRed
titlenot visible to public
Status
colourYellow
titleready for review
still need to make the diagram

...

Type

...

Explanation/Reference

...

Reader

...

Clients / CSMs

...

Reader goal

...

Decide how to pull and sort content for a module, most likely coming from one of these mindsets…

  • They have a specific idea (use case) in mind – “Can I do this?” If they are tech/design savvy they might look at this on their own. Otherwise, they might ask a CSM, “can I do this?” and the CSM would look at this doc to find the answer.

  • Or they/CSM have a template or prebuilt module that they want to adjust. “I want to change this default. What are all my options?”

They do NOT want to think about how it all works on the back end. They are focused on use case.

Learning goal: Understand all parts of how content is pulled and sorted. Be able to fill in the “formula” with their choices and hand it to the CSM/Config team

...

Contributors

...

Nelly, Scrilla

...

JUNO version

...

Reviewers (check the box when you’re done!)

...

  •  Scrilla
  •  Travis
  •  Some CSMs
  •  Leon (just the recommended tags section)

...

Review deadline

...

...

Notes for reviewers

Let me know if anything comes to mind that’d make something easier to understand. (smile) Thank you all. This one’s a beast! (smile)

  • Scrilla, the red section at the bottom is particularly for you.

  • Leon, Scrilla and I would like some assistance making sure I got the add_users_tag_types and require_some_preferred_tags_of_type right. It’s the Personalized recommendations section.

To build your own module, you need to To build your own rotator, grid, or list module, you must decide which content it will showcase.

Content can be pulled and sorted in creative ways. If you have a highly custom idea, this page will help you learn about your options and build it from scratch.

Or , check out our prebuilt modules to get inspired by common examples. You might even start with a prebuilt module, then check out the options on this page to request some changes.

(tick) Build your own module in two steps

Contents
How it works
Pull content types
Narrow down the content selection
Sort the content

...

How it works
Anchor
How-it-works
How-it-works

Content is automatically pulledinto modules from your site’s content management system. So to To tell the system which content you want to display, we have to define it in three steps:.

...

First, you must choose which typeofcontentto pull into the module. Then, you’ll usually want to narrow down the content to a smaller selection. Finally, you can choose to sortthecontent so it appears in a specific order.

The form below can help you communicate your ideas. But if you get stuck, just tell your JUNO team representative Success Manager about your goal , and they’ll help with recommendations!.

The goal of this module is:

Pull these content type(s): This step is required. The rest are optional.

Then narrow it down…

Only
  • Show content with this session status:

Only
  • Show content with these tag(s):

  • Hide content with these tags(s):

  • Make personalized recommendations based on access level: Specify Strict or Flexible

  • Makepersonalized recommendations based on these profile tag types: Name tag types and specify Strict or Flexible

Then sort it all by:

...

Anchor
pull
pull
1. Pull content types (required)

...

Usually, you only need one type. But you can choose multiple. A common example of multiple content types in a module is Session + LibraryOn-demand content. This module would offer attendees a mix of live and on-demand content.

Choose one or more content types…

(tick) Sessions (You must also specify Main stage, Panel, and/or Breakout.)
(tick) In-person sessions

(You must also specify Main stage, Panel, and/or Breakout.)


(tick)

Library

On-demand
(tick) Exhibitors
(tick) Speakers
(tick) Courses
(tick)

Lessons
(tick)

Resources (This is often used for billboard advertisement graphics.)
(tick) Social feed posts
(tick) Forum posts

Include Page
REUSE - New course limitations warning
REUSE - New course limitations warning

You can stop here if you’d you like! The next steps are optional. Note that if you don’t sort (step 3), the module will by default show shows content with the most recent latest release date first to highlight recently released content.

...

Anchor
narrow
narrow
2. Narrow down the content selection (optional)

After choosing a content type, you’ll often want to narrow it down so the module is focused on a specific topic, availability, or personalized recommendation. For example, instead of showing any course session, a module might only show courses sessions about “leadership”.

You can narrow content down by specifying a Session status, Tags, Actions, or Personalized recommendations. Learn about each option below.

Session status

Use a single method alone or try combining them in creative ways.

Session status
Anchor
Session-status
Session-status

If you pull Sessions or In-person sessions into the module, you can narrow it down to sessions with a specific status. A session’s status changes over time as it goes from Upcoming, to Live, to Past.

Choose a session status…

(tick) Live now
(tick) Upcoming

and Live now


(tick)

Past

Upcoming and Live now

Note that the module will appear empty is hidden whenever there aren’t are no sessions with the specified status. For example, you might not choose Live now if your event has a lot of downtime a Live now module would disappear during an event’s break time in between live sessions.

Tags
Anchor
Tags
Tags

You can narrow down any content type to show only content that has specific tags. Or you can do the opposite: Hide content that has specific tags applied to it.

Note that every attendee will see sees the same content when you specify tags. If you want to show attendees personalized recommendations, use the Personalized recommendations option below.

To specify tags…

(tick)Choose

any profile,

tags to show content (usually profile, topic, layout, and/or access level tags)
(tick)Choose tags to hide content (usually profile, topic, layout, and/or access level tags)

Info

If you choose multiple tags, you can also decide to require all. This means that content only appears in the module if it has every specified tag. Otherwise, content appears as long as it has at least one of the tags.

Profile tags are any tags attendees select when they create their profile. For example, an onboarding question might ask about their interests, with multiple options like Leadership and Design. Any of these tags can be applied to related content and pulled into the module.

If the module you’re creating you create isn’t related to any profile tags, you should create a new layout tag. Usually, a layout tag simply matches the module title or page title. For example, if a module is titled Featured Sessions, create a Featured Sessions tag and add it to each piece of content that you’d like to appear in that module.

Access level tags lock content so that only attendees who have permission or who bought a specific ticket can open it. When you specify access level tags for a module, it will only show shows content with that access level. Attendees who don’t have access will still see it, but it will have has a lock icon. If they click it, they can be prompted to purchase a ticket on an external site. Learn more about access levels on content.

Actions
Anchor
Actions
Actions

You can narrow down any content type to show only content that a user has performed a specified action on. Or you can do the opposite: Show content that a user has not performed the specified action on.

Note that every user sees different content depending on whether or not they performed the action.

To specify actions…

(tick)Choose one or more actions that must be completed, and the module shows users content that they performed the action(s) on.
(tick)Choose one or more actions that must NOT be completed, and the module shows users content that they did not perform the action(s) on.

Here are some common ways to use actions:

  • Show courses that you have Started but not yet Completed.

  • Show speakers and exhibitors that you have Favorited.

  • Show sessions that you have added to your schedule by clicking the Attend button. (This is usually displayed as a My Schedule tab on the schedule page.

Personalized recommendations
Anchor
Personalized-recommendations
Personalized-recommendations

You can narrow down any content type to show personalized recommendations for attendees. Each attendee will see sees different content in the module, depending on the tags they selected in their profile or their access level tags.

Choose one way to make recommendations based on access

level…

level tags…

(tick) Strict access level recommendation

will

only

show

shows attendees content that’s

special

specific to their access level. For example, one attendee might see all Level 1 Sessions, while another attendee sees allLevel 2 Sessions.

(tick) Flexible access level recommendation

will show

shows content

special

specific to their access level, but also content that doesn’t have an access level at all. This option is best when you want to make recommendations but also want to encourage attendees to discover new things.

Note that if someone isn’t assigned an access level, they see content for all access levels instead.

Or make recommendations based on profile tags…

(tick) Choose one or more profile tag types, and the module

will show

shows attendees content they’re interested in. You also must decide if it’s a strict or flexible recommendation.

For example, an onboarding question might ask attendees about their interests, with multiple options like Leadership and Design. Interests is the tag type, while Leadership and Design are the tags.

If you narrow the module content to recommendations based on the Interests tag type, one attendee will see sees content about Leadership and another will see sees content about Design.Flexible recommendations will show . Note that if someone didn’t select any tags, they see all Interests content instead.

A flexible recommendation shows additional content beyond the tag type(s) you specified. For example, if some content isn’t related to the Interest tag type at all, it could still show up in the module. This option is best when you want to make recommendations but also want to encourage attendees to discover new things.

Strict recommendations will only show A strict recommendation only shows content from that tag type. It narrows down your content much further. This option is best when you want the module to be highly focused focus on a specific topic.

...

Anchor
sort
sort
3. Sort the content (optional)

Choose one way to sort the content in the module. Note that if you don’t sort, the module will by default show shows content with the most recent latest release date first to highlight recently released content.

Unsure if these have a use case for modules/what they are

  • 1 = sort num responses descending 

  • 5 = sort children descending 

  • 6 = sort children ascending 

  • 12 = sort day and month ascending 

  • 13 = sort rotate every four hours 

  • 14 = sort rotate every hour

  • 16 = sort string option1 

  • 17 = sort string option2 

  • 18 = sort string option3 

  • 19 = sort match against score 

  • 21 = sort child ascending2 

  • 22 = sort content descending2 

  • 100 = sort pinned tag 

  • 101 = sort bucket tag ascending 

  • 102 = sort getty special 

  • 103 = sort tag order 

Pretty sure these aren’t for modules…

...

10 = sort rank descending 

...

11 = sort rank ascending 

...

9 = sort action completed 

...

23 = sort most completed action 

...

Choose one way to sort…

Definition

(tick) Release date (earliest to latest, or latest to earliest)

Release is when the content becomes viewable. For example, a piece of

library

on-demand content might not be released until a specific date. A session might be released well before

it’s

its start time.

(tick) Start date (earliest to latest, or latest to earliest)

Start is when the content (such as a session) begins.

This is only for sessions

Only some content types have a start date.

(tick) Alphabetical by title

Use this if the first character in the title is a letter. Note that speakers

are

can be sorted by the first character in their first name orlast name.

(tick) Numerical by title (ascending or descending)

Use this if the first character in the title is a number. For example, 1

Library

Session and 2

Library

Session. Note this doesn’t work if the first character is a letter. For example, Session 1 and Session 2

will

do not sort numerically.

(tick) Popularity over time

Amount of views over time. If content is viewed 100 times in the last five minutes it is more popular than content viewed 100 times over a month.

(tick) Random

Changes each time you reload the page

.

(tick) Popularity

Tag score then date

.

...