README - BCHDME

README

Side Bars

Create a new sidebar under Content Aware.

  1. Add sections and topics to the conditions.
  2. Under Action, select Force Replace > Learn Dash Courses
  3. Select the new sidebar from the Quick Select menu in the page on section or topic on which you want the sidebar to appear.

Team Members Object

Shortcodes

@description: The Team members shortcode can display all team members or team member from a business section. The team members will be displayed in alphabetical order based on last name and first name.
[team] Display all team members.
[team team="graduate-medical-education"] Display team members form the “graduate-medical-education” team.
[team team="graduate-medical-education, undergraduate-medical-education"] Display team members that are in the “graduate-medical-education” or “undergraduate-medical-education” team.
@example [team team="graduate-medical-education"]

Sarah Pitts, MD

Ariel Winn, MD

News Object

Shortcodes

@description: The news shortcode can display 1 news articles per shortcode based on the post name. The read more link can point to its detailed page or the source of the article if the URL was added to the news object. When news items are added they will not display anywhere. There will only be a detail page that can be linked to by a short code. If the news item has a source URL set, the read more link will go to that source in a new tab instead of the detailed page in the same tab.
[news_article slug="news-test1"] Display news article based on news articles slug.
@example [news_article slug="news-test1"]

News test1

This is a news item. The news shortcode can display 1 news articles per shortcode based on the post name. The read more link can point to its detailed page or the source of the article if the URL was added to the news object. When news items are added they will not display anywhere. There will only be a detail page that can be linked to by a short code. If the news item has a source URL set, the read more link will go to that source in a new tab instead of the detailed page in the same tab.

Contacts Object

Shortcodes

@description: The Contacts shortcode can display all Contacts or Contacts from a business section.
[contacts] Display all contacts in the contacts post type.
[contacts team="graduate-medical-education"] Display contacts form the “graduate-medical-education” team.
[contacts team="graduate-medical-education, undergraduate-medical-education"] Display contacts that are in the “graduate-medical-education” or “undergraduate-medical-education” team.
@example [contacts]

Newsletters Object

Shortcodes

@description:
[newsletters] Display all newsletters, 5 per page.
[newsletters-archive] List all newsletters titles. All links download the PDF newsletter.
@example [newsletters]

Fall 2020

WHAT'S INSIDE | Upcoming Events; BCH Trainee Recruitment Goes 'Virtual'; CAPS/NAM Wellness Poster; BCH Wellness Pledge; BCH Sets Goals in IDE; ACGME Timeline of Progress; 2020 Marshall Klaus Awards; BCH Wellness Poster

@example [newsletters-archive]

Events object

How to create or edit an event

There are two Events Options in the editor menu – the black left side menu in the WordPress backend. For the large block display type, select the Events option with the thumbtack icon: 

Select “Add New” at the top of the page to add a new event, or select and existing event to edit it. Add/edit the event information in the appropriate fields. To link to a RSVP form on Surveymonkey or other external site, enter “RSVP” in the Register Label field, and enter the URL of the external form in the Register URL field.

When you are ready to publish the event, select Update on the right side of the page: .

Or, you want to save the event without publishing, select Save Draft on the right side of the page: 

Shortcodes

@description: The events shortcode displays events from based on the start date and time. The team names can be found in the events object taxonomy section.
@param team Optional; Default: false; Items per business section
@param events Optional; Default: 5; Items per page
@param upnext Optional; Default: false; Condensed list of items
[events] Display all events, 5 per page.
[events team="graduate-medical-education"] Display graduate medical education events, 5 per page.
[events events="7"] Display all events, 7 per page.
[events upnext="true" events="3"] Display 3 upcoming events from all business sections.
@example [events team="graduate-medical-education"]

14Mar

House Staff Quality Council Patient Safety Grand Rounds

LocationTBD
Date & TimeTuesday, March 14, 12:00AM - Wednesday, March 14, 12:00AM
Internal employees only 
23Apr

House Staff Appreciation Week

LocationTBD
Date & TimeMonday, April 23, 12:00AM - Friday, April 27, 12:00AM
25Apr

Graduate Medical Education Grand Rounds

LocationTBD
Date & TimeWednesday, April 25, 12:00AM - 12:00AM

@example [events upnext="true" events="3"]

Misc Shortcodes

External_CTA

@description:
@param title Required @param url Required
@param desc Optional; Default: ”
[external_cta title="My Portal" desc="The description here"] External CTA with description.
[external_cta title="My Portal" url="http://childrenshospital.org"] External CTA without description.
@example [external_cta title="My Portal" url="http://childrenshospital.org" desc="The description here"]

Mmsc Date

@description:
@param format Optional; Default: ‘Y’
@NOTE https://secure.php.net/manual/en/function.date.php
[mmsc_date format="Y"] PHP generated date: current year
@example [mmsc_date format="Y"]
2021
@example [mmsc_date format="\\D\\a\\t\\e\\: l F jS Y \\T\\i\\m\\e\\: H:i:s"]
Date: Monday April 19th 2021 Time: 08:12:43

Back button

@description: Allows you to add in a button that will link to the previously visited page. This button can also be used to link to a page of your choice.
@param url Optional; Default: Previously visited page
@param label Optional; Default: ‘Back’
[backbtn label="Back"] Links back to the previously visited page.
[backbtn label="back with url" url="http://google.com" ] Links to any page inserted in to the url parameter.
@example [backbtn label="back to previous page"]

@example [backbtn label="back with url" url="http://google.com" ]

Accordions

@description: Accordion content can be displayed using 2 shortcodes. [accordion][/accordion] is used as the container and accordion content is enclosed in [accordion_item][/accordion_item].
It is important to make sure ther is no space or line return inbetween the shortcodes and that the shortcodes are closed.
@param[accordion_item][/accordion_item] title Required; Accordion title
[accordion][accordion_item title="The accordion 1"]<h3>The accordion content 1</h3>[/accordion_item][accordion_item title="The accordion 2"]<h3>The accordion content 2</h3>[/accordion_item][/accordion] The accordion content with multiple items
@example [accordion][accordion_item title="The accordion 1"]<h3>The accordion content 1</h3>[/accordion_item][accordion_item title="The accordion 2"]<h3>The accordion content 2</h3>[/accordion_item][/accordion]

The accordion 1

<h3>The accordion content 1</h3>

The accordion 2

<h3>The accordion content 2</h3>

Tabbed Content

@description: Tabbed content can be displayed using 2 shortcodes. [tabs][/tabs] is used as the container and tab content is enclosed in [tab][/tab].
It is important to make sure ther is no space or line return inbetween the shortcodes and that the shortcodes are closed.
@param[tab][/tab] title Required; Tab title
[tabs][tab title="Tab 1"]<h3>The tab content 1</h3>[/tab][tab title="Tab 2"]<h3>The tab content 2</h3>[/tab][/tabs] Tabbed content with multiple tabs
@example [tabs][tab title="Tab 1"]<h3>The tab content 1</h3>[/tab][tab title="Tab 2"]<h3>The tab content 2</h3>[/tab][/tabs]

The tab content 1

The tab content 2

Uploads Mime Types

Image

  • jpg|jpeg|jpe – image/jpeg
  • gif – image/gif
  • png – image/png
  • bmp – image/bmp
  • tiff|tif – image/tiff
  • ico – image/x-icon
  • svg – image/svg+xml

Video

  • asf|asx – video/x-ms-asf
  • wmv – video/x-ms-wmv
  • wmx – video/x-ms-wmx
  • wm – video/x-ms-wm
  • avi – video/avi
  • divx – video/divx
  • flv – video/x-flv
  • mov|qt – video/quicktime
  • mpeg|mpg|mpe – video/mpeg
  • mp4|m4v – video/mp4
  • ogv – video/ogg
  • webm – video/webm
  • mkv – video/x-matroska
  • 3gp|3gpp – video/3gpp
  • 3g2|3gp2 – video/3gpp2

Text

  • txt|asc|c|cc|h|srt – text/plain
  • csv – text/csv
  • tsv – text/tab-separated-values
  • ics – text/calendar
  • rtx – text/richtext
  • css – text/css
  • htm|html – text/html
  • vtt – text/vtt

Audio

  • mp3|m4a|m4b – audio/mpeg
  • ra|ram – audio/x-realaudio
  • wav – audio/wav
  • ogg|oga – audio/ogg
  • mid|midi – audio/midi
  • wma – audio/x-ms-wma
  • wax – audio/x-ms-wax
  • mka – audio/x-matroska

Other file types

  • dfxp – application/ttaf+xml
  • rtf – application/rtf
  • js – application/javascript
  • pdf – application/pdf
  • class – application/java
  • tar – application/x-tar
  • zip – application/zip
  • gz|gzip – application/x-gzip
  • rar – application/rar
  • 7z – application/x-7z-compressed
  • psd – application/octet-stream
  • xcf – application/octet-stream
  • doc – application/msword
  • pot|pps|ppt – application/vnd.ms-powerpoint
  • wri – application/vnd.ms-write
  • xla|xls|xlt|xlw – application/vnd.ms-excel
  • mdb – application/vnd.ms-access
  • mpp – application/vnd.ms-project
  • docx – application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • docm – application/vnd.ms-word.document.macroEnabled.12
  • dotx – application/vnd.openxmlformats-officedocument.wordprocessingml.template
  • dotm – application/vnd.ms-word.template.macroEnabled.12
  • xlsx – application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • xlsm – application/vnd.ms-excel.sheet.macroEnabled.12
  • xlsb – application/vnd.ms-excel.sheet.binary.macroEnabled.12
  • xltx – application/vnd.openxmlformats-officedocument.spreadsheetml.template
  • xltm – application/vnd.ms-excel.template.macroEnabled.12
  • xlam – application/vnd.ms-excel.addin.macroEnabled.12
  • pptx – application/vnd.openxmlformats-officedocument.presentationml.presentation
  • pptm – application/vnd.ms-powerpoint.presentation.macroEnabled.12
  • ppsx – application/vnd.openxmlformats-officedocument.presentationml.slideshow
  • ppsm – application/vnd.ms-powerpoint.slideshow.macroEnabled.12
  • potx – application/vnd.openxmlformats-officedocument.presentationml.template
  • potm – application/vnd.ms-powerpoint.template.macroEnabled.12
  • ppam – application/vnd.ms-powerpoint.addin.macroEnabled.12
  • sldx – application/vnd.openxmlformats-officedocument.presentationml.slide
  • sldm – application/vnd.ms-powerpoint.slide.macroEnabled.12
  • onetoc|onetoc2|onetmp|onepkg – application/onenote
  • oxps – application/oxps
  • xps – application/vnd.ms-xpsdocument
  • odt – application/vnd.oasis.opendocument.text
  • odp – application/vnd.oasis.opendocument.presentation
  • ods – application/vnd.oasis.opendocument.spreadsheet
  • odg – application/vnd.oasis.opendocument.graphics
  • odc – application/vnd.oasis.opendocument.chart
  • odb – application/vnd.oasis.opendocument.database
  • odf – application/vnd.oasis.opendocument.formula
  • wp|wpd – application/wordperfect
  • key – application/vnd.apple.keynote
  • numbers – application/vnd.apple.numbers
  • pages – application/vnd.apple.pages

Content Styles

Headings

Header one

Header two

Header three

Header four

Header five
Header six

Blockquotes

Single line blockquote:

Stay hungry. Stay foolish. – By: Steve Jobs

Multi line blockquote with a cite reference:

Love the H3 experience

People think focus means saying yes to the thing you’ve got to focus on. But that’s not what it means at all. It means saying no to the hundred other good ideas that there are. You have to pick carefully. I’m actually as proud of the things we haven’t done as the things I have done. Innovation is saying no to 1,000 things.

Steve Jobs – Apple Worldwide Developers’ Conference, 1997

Tables

Employee Salary
John Doe $1 Because that’s all Steve Jobs needed for a salary.
Jane Doe $100K For all the blogging she does.
Fred Bloggs $100M Pictures are worth a thousand words, right? So Jane x 1,000.
Jane Bloggs $100B With hair like that?! Enough said…

Definition Lists

Definition List Title
Definition list division.
Startup
A startup company or startup is a company or temporary organization designed to search for a repeatable and scalable business model.
#dowork
Coined by Rob Dyrdek and his personal body guard Christopher “Big Black” Boykins, “Do Work” works as a self motivator, to motivating your friends.
Do It Live
I’ll let Bill O’Reilly will explain; this one.

Unordered Lists (Nested)

  • List item one
    • List item one
      • List item one
      • List item two
      • List item three
      • List item four
    • List item two
    • List item three
    • List item four
  • List item two
  • List item three
  • List item four

Ordered List (Nested)

  1. List item one
    1. List item one
      1. List item one
      2. List item two
      3. List item three
      4. List item four
    2. List item two
    3. List item three
    4. List item four
  2. List item two
  3. List item three
  4. List item four

HTML Tags

These supported tags come from the WordPress.com code FAQ;.

Address Tag

1 Infinite Loop, Cupertino, CA 95014United States

Anchor Tag (aka. Link)

This is an example of a link;.

Abbreviation Tag

The abbreviation srsly stands for “seriously”.

Acronym Tag (deprecated in HTML5)

The acronym ftw stands for “for the win”.

Big Tag (deprecated in HTML5)

These tests are a big deal, but this tag is no longer supported in HTML5.

Cite Tag

“Code is poetry.” –Automattic

Code Tag

You will learn later on in these tests that word-wrap: break-word; will be your best friend.

Delete Tag

This tag will let you strikeout text, but this tag is no longer supported in HTML5 (use the <strike> instead).

Emphasize Tag

The emphasize tag should italicize text.

Insert Tag

This tag should denote inserted text.

Keyboard Tag

This scarcely known tag emulates keyboard text, which is usually styled like the <code> tag.

Preformatted Tag

This tag styles large blocks of code.

.post-title {
                    margin: 0 0 5px;
                    font-weight: bold;
                    font-size: 38px;
                    line-height: 1.2;
                    and here's a line of some really, really, really, really long text, just to see how the PRE tag handles it and to find out how it overflows;
                }

Quote Tag

Developers, developers, developers… –Steve Ballmer

Strike Tag (deprecated in HTML5)

This tag shows strike-through text

Strong Tag

This tag shows bold text.

Subscript Tag

Getting our science styling on with H2O, which should push the “2” down.

Superscript Tag

Still sticking with science and Isaac Newton’s E = MC2, which should lift the 2 up.

Teletype Tag (deprecated in HTML5)

This rarely used tag emulates teletype text, which is usually styled like the <code> tag.

Variable Tag

This allows you to denote variables.

Image alignment

The best way to demonstrate the ebb and flow of the various image positioning options is to nestle them snuggly among an ocean of words. Grab a paddle and let’s get started. On the topic of alignment, it should be noted that users can choose from
the options of None, Left, Right, and Center. In addition, they also get the options of Thumbnail, Medium, Large & Fullsize.

Image Alignment 580x300

The image above happens to be centered.

Image Alignment 150x150The rest of this paragraph is filler for the sake of
seeing the text wrap around the 150×150 image, which is left aligned. As you can see the should be some space above, below, and to the right of the image. The text should not be creeping on the image. Creeping is just not
right. Images need breathing room too. Let them speak like you words. Let them do their jobs without any hassle from the text. In about one more sentence here, we’ll see that the text moves from the right of the image down below the image in seamless
transition. Again, letting the do it’s thang. Mission accomplished! And now for a massively large image. It also has no alignment.

Image Alignment 1200x400 The image above, though 1200px wide, should not overflow the content area.
It should remain contained with no visible disruption to the flow of content.

Image Alignment 300x200 And now we’re going to shift things to the right align.
Again, there should be plenty of room above, below, and to the left of the image. Just look at him there… Hey guy! Way to rock that right side. I don’t care what the left aligned image says, you look great. Don’t let anyone else tell you differently. In just a bit here, you should see the text start to wrap below the right aligned image and settle in nicely. There should still be plenty of room and everything should be sitting pretty. Yeah… Just like that. It never felt so good to be right.

Image alignment with captions

Image Alignment 580x300
Look at 580×300 getting some caption; love.

The image above happens to be centered. The caption also has a link in it, just to see if it does anything funky.

Image Alignment 150x150

Itty-bitty caption.

The rest of this paragraph is filler for the sake of seeing the text wrap around the 150×150 image, which is left aligned. As you can see the should be some space above, below, and to the right of the image. The text should not be creeping on the image. Creeping is just not right. Images need breathing room too. Let them speak like you words. Let them do their jobs without any hassle from the text. In about one more sentence here, we’ll see that the text moves from the right of the image down below the image in seamless transition. Again, letting the do it’s thang. Mission accomplished! And now for a massively large image. It also has no alignment.

Image Alignment 1200x400

Massive image comment for your eyeballs.

The image above, though 1200px wide, should not overflow the content area. It should remain contained with no visible disruption to the flow of content.

Image Alignment 300x200

Feels good to be right all the time.

And now we’re going to shift things to theright align. Again, there should be plenty of room above, below, and to the left of the image. Just look at him there… Hey guy! Way to rock that right side. I don’t care what the left aligned image says, you look great. Don’t let anyone else tell you differently. In just a bit here, you should see the text start to wrap below the right aligned image and settle in nicely. There should still be plenty of room and everything should be sitting pretty. Yeah… Just like that. It never felt so good to be right. And that’s a wrap, yo! You survived the tumultuous waters of alignment. Image alignment achievement unlocked!

Embeds

Youtube

Just add the URL to the page on a new line.
https://www.youtube.com/watch?v=QKsUBpo04PM

Markup: Text Alignment

Default

This is a paragraph. It should not have any alignment of any kind. It should just flow like you would normally expect. Nothing fancy. Just straight up text, free flowing, with love. Completely neutral and not picking a side or sitting on the fence. It just is. It just freaking is. It likes where it is. It does not feel compelled to pick a side. Leave him be. It will just be better that way. Trust me.

Left Align

This is a paragraph. It is left aligned. Because of this, it is a bit more liberal in it’s views. It’s favorite color is green. Left align tends to be more eco-friendly, but it provides no concrete evidence that it really is. Even though it likes share the wealth evenly, it leaves the equal distribution up to justified alignment.

Center Align

This is a paragraph. It is center aligned. Center is, but nature, a fence sitter. A flip flopper. It has a difficult time making up its mind. It wants to pick a side. Really, it does. It has the best intentions, but it tends to complicate matters more than help. The best you can do is try to win it over and hope for the best. I hear center align does take bribes.

Right Align

This is a paragraph. It is right aligned. It is a bit more conservative in it’s views. It’s prefers to not be told what to do or how to do it. Right align totally owns a slew of guns and loves to head to the range for some practice. Which is cool and all. I mean, it’s a pretty good shot from at least four or five football fields away. Dead on. So boss.

Justify Align

This is a paragraph. It is justify aligned. It gets really mad when people associate it with Justin Timberlake. Typically, justified is pretty straight laced. It likes everything to be in it’s place and not all cattywampus like the rest of the aligns. I am not saying that makes it better than the rest of the aligns, but it does tend to put off more of an elitist attitude.

Hero

@description: The Hero component can be turned on and off on any page or post type and needs at least an image and a title. Because pages have hierarchy they can inherit their parents Hero. I the parents Hero is inherited you can still overwrite any of the content.

Footer Banner / CTA

@description: The Footer banner is very simular to the Hero but can not overwrite single fields if it is inherited from a child page.

Customizer

@description: The customizer is used to set the:

  • Favicon
  • Logo
  • Social Media URL’s
  • WP Menus
  • WP widgets
  • Custom CSS

Side Navigation Menu

@description: The side nav menu can be created under apperance > menus. Click “create a new menu” and then click “create menu”.
You can also duplicate a menu by going to apperance > Duplicate menu, choose a menu from the selectbox and insert a title.
Sidenav menus can be assigned to any page or custom post type using the meta box on that page or custom post type. Because pages have hierarchy they will inherrit their parents menu by default.

User Roles & Capabilities

WordPress

@description: WordPress uses a concept of Roles, designed to give the site owner the ability to control what users can and cannot do within the site. Plugins can add user roles and capabilities or edit them to control how different user roles can use the plugin.
USER ROLES

  • Super Admin – somebody with access to the site network administration features and all other features. See the Create a Network article.
  • Administrator – somebody who has access to all the administration features within a single site.
  • Editor – somebody who can publish and manage posts including the posts of other users.
  • Author – somebody who can publish and manage their own posts.
  • Contributor – somebody who can write and manage their own posts but cannot publish them.
  • Subscriber – somebody who can only manage their profile.

The default role for new users can be set in Administration Panels > Settings > General.

More detailed information can be found in the WordPress codex: https://codex.wordpress.org/Roles_and_Capabilities

Learndash

@description: Learndash adds the group_leader user role to wordpress and a number of capabilities that are by default assigned to the administrator.
Groupleader Capabilities

  • group_leader ( both a role capability and user role)
  • enroll_users

All Admin LD Assignment custom capabilities

  • read_assignment
  • edit_assignment
  • edit_assignments
  • edit_others_assignments
  • publish_assignments
  • read_assignment
  • read_private_assignments
  • delete_assignment
  • edit_published_assignments
  • delete_others_assignments
  • delete_published_assignments

All Admin LD Quiz Essay custom capabilities

  • edit_essays
  • edit_others_essays
  • publish_essays
  • read_essays
  • read_private_essays
  • delete_essays
  • edit_published_essays
  • delete_others_essays
  • delete_published_essays

All Admin LD Quiz custom capabilities

  • wpProQuiz_show
  • wpProQuiz_add_quiz
  • wpProQuiz_edit_quiz
  • wpProQuiz_delete_quiz
  • wpProQuiz_show_statistics
  • wpProQuiz_reset_statistics
  • wpProQuiz_import
  • wpProQuiz_export
  • wpProQuiz_change_settings
  • wpProQuiz_toplist_edit
  • wpProQuiz_toplist_edit

BBPress

@description: bbPress comes built in with user Roles that give the website owner the ability to tailor user access to their website.
The default bbPress Roles are:

  • Keymaster – Can create, edit and delete other users’ forums, topics and replies. Can manage Tags, and moderate a forum with the moderation tools. Has access to global forum settings, tools, and importer.
  • Moderator – Can create and edit forums. Can create, edit and delete other users’ topics and replies. Can manage Tags, and moderate a forum with the moderation tools.
  • Participant – Can create and edit their own topics and replies.
  • Spectator – Can only read topics and replies.
  • Blocked – All capabilities are explicitly blocked.

More detailed information can be found at: https://codex.bbpress.org/getting-started/before-installing/bbpress-user-roles-and-capabilities/

Learndash Short codes

Learndash Course Shortcodes

Shortcode Options

You may use shortcodes to add information to any page/course/lesson/quiz. Here are built-in shortcodes for displaying relavent user information.

[ld_profile]

Displays user’s enrolled courses, course progress, quiz scores, and achieved certificates. This shortcode can take following parameters:

  • order: sets order of courses. Default value DESC. Possible values: DESC, ASC. Example: [ld_profile order="ASC"] shows courses in ascending order.
  • orderby: sets what the list of ordered by. Default value ID. Possible values: ID, title. Example: [ld_profile orderby="ID" order="ASC"] shows courses in ascending order by title.

See the full list of available orderby options here.

[ld_course_list]

This shortcode shows list of courses. You can use this shortcode on any page if you dont want to use the default /courses page. This shortcode can take following parameters:

  • num: limits the number of courses displayed. Example: [ld_course_list num="10"] shows 10 courses.
  • order: sets order of courses. Possible values: DESC, ASC. Example: [ld_course_list order="ASC"] shows courses in ascending order.
  • orderby: sets what the list of ordered by. Example: [ld_course_list order="ASC" orderby="title"] shows courses in ascending order by title.
  • mycourses: show current user’s courses. Example: [ld_course_list mycourses="true"] shows courses the current user has access to.
  • col: number of columns to show when using course grid addon. Example: [ld_course_list col="2"] shows 2 columns.
  • cat: shows courses with mentioned category id. Example: [ld_course_list cat="10"] shows courses having category with category id 10.
  • category_name: shows courses with mentioned category slug. Example: [ld_course_list category_name="math"] shows courses having category slug math.
  • categoryselector: shows a course category dropdown. Example: [ld_course_list categoryselector="true"].
  • tag: shows courses with mentioned tag. Example: [ld_course_list tag="math"] shows courses having tag math.
  • tag_id: shows courses with mentioned tag_id. Example: [ld_course_list tag_id="30"] shows courses having tag with tag_id 30.
  • course_cat: shows courses with mentioned course category id. Example: [ld_course_list course_cat="10"] shows courses having course category with category id 10.
  • course_category_name: shows courses with mentioned course category slug. Example: [ld_course_list course_category_name="math"] shows courses having course category slug math.
  • course_categoryselector: shows a category dropdown. Example: [ld_course_list course_categoryselector="true"].
  • course_tag: shows courses with mentioned course tag. Example: [ld_course_list course_tag="math"] shows courses having course tag math.
  • course_tag_id: shows courses with mentioned course_tag_id. Example: [ld_course_list course_tag_id="30"] shows courses having course tag with tag_id 30.

See the full list of Category and Tag filtering options.

[ld_lesson_list]

This shortcode shows list of lessons. You can use this shortcode on any page. This shortcode can take following parameters: num, order, orderby, tag, tag_id, cat, category_name lesson_tag, lesson_tag_id, lesson_cat, lesson_category_name, lesson_categoryselector. See [ld_course_list] above details on using the shortcode parameters.

[ld_topic_list]

This shortcode shows list of topics. You can use this shortcode on any page. This shortcode can take following parameters: num, order, orderby, tag, tag_id, cat, category_name, topic_tag, topic_tag_id, topic_cat, topic_category_name, topic_categoryselector. See [ld_course_list] above details on using the shortcode parameters.

[ld_quiz_list]

This shortcode shows list of quizzes. You can use this shortcode on any page. This shortcode can take following parameters: num, order, orderby. See [ld_course_list] above details on using the shortcode parameters.

[learndash_course_progress]

This shortcode displays users progress bar for the course in any course/lesson/quiz pages.

[visitor]]

This shortcode shows the content if the user is not enrolled in the course. The shortcode can be used on any page or widget area. This shortcode can take following parameters:

  • course_id: Optional. Show content if the student does not have access to a specific course. Example: [[visitor course_id="10"]]insert any content[[/visitor]

[student]]

This shortcode shows the content if the user is enrolled in the course. The shortcode can be used on any page or widget area. This shortcode can take following parameters:

  • course_id: Optional. Show content if the student has access to a specific course. Example: [[student course_id="10"]]insert any content[[/student]

[course_complete]]

This shortcode shows the content if the user has completed the course. The shortcode can be used on any page or widget area. This shortcode can take following parameters:

  • course_id: Optional. Show content if the student has access to a specific course. Example: [[course_complete course_id="10"]]insert any content[[/course_complete]
  • user_id: Optional. If not provided will use current logged in user. Example: [course_complete course_id="10" user_id="456"]]insert any content[[/course_complete]

[course_inprogress]]

This shortcode shows the content if the user has started but not completed the course. The shortcode can be used on any page or widget area. This shortcode can take following parameters:

  • course_id: Optional. Show content if the student has access to a specific course. Example: [[course_inprogress course_id="10"]]insert any content[[/course_inprogress]
  • user_id: Optional. If not provided will use current logged in user. Example: [course_inprogress course_id="10" user_id="456"]]insert any content[[/course_inprogress]

[course_notstarted][]

This shortcode shows the content if the user has access to the course but not yet started. The shortcode can be used on any page or widget area. This shortcode can take following parameters:

  • course_id: Optional. Show content if the student has access to a specific course. Example: [pcourse_notstarted course_id=”10″]]insert any content[[/course_notstarted]
  • user_id: Optional. If not provided will use current logged in user. Example: [course_notstarted course_id="10" user_id="456"]]insert any content[[/course_notstarted]

[ld_course_info]

This shortcode shows the courses for the user. This shortcode can take following parameters: user_id if not provided will assume current user. Example usage: [ld_course_info user_id="123"] will show the courses for the user 123

[ld_user_course_points]

This shortcode shows the earned course points for the user. This shortcode can take following parameters: user_id if not provided will assume current user. Example usage: [ld_user_course_points]

[user_groups]

This shortcode displays the list of groups users are assigned to as users or leaders.

[ld_group]]

This shortcode shows the content if the user is enrolled in a specific group. Example usage: [[ld_group]]Welcome to the Group![[/ld_group] This shortcode takes the following parameters:

  • group_id: Required. Show content if the student has access to a specific group. Example: [ld_group group_id="16"]]insert any content[[/ld_group]

[[ld_video]]

This shortcode is used on Lessons and Topics where Video Progression is enabled. The video player will be added above the content. This shortcode allows positioning the player elsewhere within the content. This shortcode does not take any parameters.

[learndash_payment_buttons]

This shortcode can show the payment buttons on any page. Example: shows the payment buttons for course with Courses ID: 123

[course_content]

This shortcode displays the Course Content table (lessons, topics, and quizzes) when inserted on a page or post. Example: [course_content course_id="123"] shows the course content for course with Course ID: 123

[ld_course_expire_status]

This shortcode displays the user course access expire date. Example: [ld_course_expire_status course_id="111" user="222" label_before="Course access will expire on:" label_after="Course access expired on:" format="F j, Y g:i a"].

  • course_id: The ID of the Course to check. If not provided will attempt to user current post. Example: [ld_course_expire_status course_id="111"]
  • user_id: The ID of the user to check. If not provided the current logged in user ID will be used. Example: [ld_course_expire_status user_id="222"]
  • label_before: The label prefix shown before the access expires. Default label is “Course access will expire on:” Example: [ld_course_expire_status label_before="Your access to this course will expire on:"]
  • label_after: The label prefix shown after access has expired. Default label is “Course access expired on:” Example: [ld_course_expire_status label_after="Your access to this course expired on:"]
  • format: The controls the format of the date/time value shown to the user. If not provided the date/time format from your WordPress sytem will be used. Example: [ld_course_expire_status format="F j, Y g:i a"]

Learndash Certificate Shortcodes

Shortcode Options

You may use shortcodes to customize the display of your certificates. Provided is a built-in shortcode for displaying user information.

[usermeta]

This shortcode takes a parameter named field, which is the name of the user meta data field to be displayed.

Example: [usermeta field="display_name"] would display the user’s Display Name.

See the full list of available fields here.

[quizinfo]

This shortcode displays information regarding quiz attempts on the certificate. This shortcode can use the following parameters:

  • SHOW: This parameter determines the information to be shown by the shortcode. Possible values are:
    1. score
    2. count
    3. pass
    4. timestamp
    5. points
    6. total_points
    7. percentage
    8. quiz_title
    9. course_title
    10. timespent

    Example: [quizinfo show="percentage"] shows the percentage score of the user in the quiz.

  • FORMAT: This can be used to change the timestamp format. Default: “F j, Y, g:i a” shows as March 10, 2001, 5:16 pm.
    Example: [quizinfo show="timestamp" format="Y-m-d H:i:s"] will show as 2001-03-10 17:16:18

See the full list of available date formating strings here.

[courseinfo]

This shortcode displays course related information on the certificate. This shortcode can use the following parameters:

  • SHOW: This parameter determines the information to be shown by the shortcode. Possible values are:
    1. course_title
    2. course_points
    3. user_course_points
    4. completed_on
    5. cumulative_score
    6. cumulative_points
    7. cumulative_total_points
    8. cumulative_percentage
    9. cumulative_timespent
    10. aggregate_percentage
    11. aggregate_score
    12. aggregate_points
    13. aggregate_total_points
    14. aggregate_timespent

    cumulative is average for all quizzes of the course.
    aggregate is sum for all quizzes of the course.

    Example: [courseinfo show="cumulative_score"] shows average points scored across all quizzes on the course.

  • FORMAT: This can be used to change the date format. Default: “F j, Y, g:i a” shows as March 10, 2001, 5:16 pm.
    Example: [courseinfo show="completed_on" format="Y-m-d H:i:s"] will show as 2001-03-10 17:16:18

See the full list of available date formating strings here.

Uncanny Owl Shortcodes

Logged in/out content views


This content is for logged-out users only.

[theme-my-login]

BB Press Shortcodes

Since Version2.0bbPress support so calledShortcodes. They have been introduced for creating macros to be used in the layout of your forum content on WordPress pages. To use any of the shortcodes simply insert the desired shortcode into any WordPress page.

To get the required numerical ID for$forum_id, $topic_id, $reply_id and $tag_idyou will need to visit your /wp-admin/ section and either by editing the post or by hovering your mouse over the applicable forum/topic/reply/tag post type you will see a numeric ID for that post eg./wp-admin/post.php?post=47

Forums

Homepage forums

– This will display your entire forum index.
  • You must be logged in to create new forums.
– Display the ‘New Forum’ form.
– Display a single forums topics. eg.

Topics

– Display the most recent 15 topics across all your forums with pagination.

Homepage README

  • You must be logged in to create new topics.
– Display the ‘New Topic’ form where you can choose from a drop down menu the forum that this topic is to be associated with.
– Display the ‘New Topic Form’ for a specific forum ID.
– Display a single topic. eg.

Replies

  • You must be logged in to reply to this topic.
– Display the ‘New Reply’ form.
– Display a single reply eg.

Topic Tags

family-communication Introduction Kahn Resources Tag1 – Display a tag cloud of all topic tags.
– Display a list of all topics associated with a specific tag. eg.

Homepage README

  • Oh, bother! No topics were found here.

Views

– Single view – Display topics associated with a specific view. Current included ‘views’ with bbPress are “popular”

  • Oh, bother! No topics were found here.
and “No Replies”
  • Oh, bother! No topics were found here.

Homepage Search

– Display the search input form.
– Display the search form template.

Account

– Display the login screen.
– Display the register screen.
– Display the lost password screen.

Statistics

Registered Users
2,816
Forums
13
Topics
41
Replies
38
Topic Tags
– Display the forum statistics.

CSS

Mark Activity Complete Button

#learndash_mark_complete_button
{ display:none !important; }

Buddy Press

Events Plugin

Assign a Group Leader to a Group

  • Start on the Dashboard. On the left sidebar under Forums, click Groups.

  • Click on the name of the group you want to modify.
  • A group has to have at least one group leader, listed under Administrators. Only group leaders will be able to create events for a group.
  • To make a regular member a group leader, click the drop-down Group Role menu next to their name and select the role Administrator.

  • Scroll back to the top of the page and click Save Changes in the top right corner.

Allow a Group Leader to Create Events

  • Each group leader also needs their site role changed. On the left sidebar under LearnDash, click Users.

  • Use the search bar in the top right to search for the group leader’s account.
  • Click the checkbox to the left of their name to select the account. At the top of the list, there’s a dropdown menu Change role to…. Select Group Leader and click Change.

  • Now, a group leader can publish and modify events only for groups they lead. All other group members can view and register for events within their groups, but they cannot create events or modify bookings other than their own.

    Create/Edit Events From Backend

    • In case you (a site administrator) want to set up or modify a particular event.
    • On the left sidebar, click Events with the calendar icon – not the one with a thumbtack icon.

    • In the list are all future published events. If you need to modify one, click on its title and edit as necessary.
    • To create an event, click Add Event at the top of the page.
    • Add a title.
    • Add a description, if necessary. Add Zoom meeting details to this field if applicable.
    • On the right sidebar under When, pick a date (or date range) and time.
    • Further down the right sidebar, choose Event Categories, if necessary.
    • In the center of the screen, in the section Where, choose a location or check the box “This event does not have a physical location” for an online-only meeting.
    • Below Where, in Bookings/Registration, check Enable registration for this event.
    • For most events, you will only need one ticket type.
    • In Total Spaces, enter the total number of people that can register for this event. For Scholars Group meetings, this is the number of presenters. Leave the field blank for unlimited registrations.
    • In Maximum Spaces Per Booking, set the number of tickets each attendee can book. In most cases, this is 1.
    • To use a custom booking form, pick the one you want from the dropdown Selected Booking Form. For Scholars Group meetings, select the Scholars Group Event form. See below for how to create a custom booking form.
    • On the right sidebar under Group Ownership, select the group that will have access to this event, if necessary. Note that all leaders of the group will be able to modify the event.
    • In the center of the screen under Author, you can select who owns the event. This is you by default, but can be changed to any user with a user role of Author, Editor, or Administrator.
      • You can not directly change the owner of an event to a group leader. The workaround for this is to go into Users, change the group leader’s role to Author, go back to the event and select them as the owner, and return to Users to change their role back to Group Leader. Their ownership of the event will remain.
    • When you are done, scroll back up to the Publish section on the right side. You can save your draft to return to it later, preview how your event will look on the site, or publish it so that it will be viewable immediately.
      • Note that an event published in a private group will have its visibility set to private automatically.

    View/Export Bookings From Backend

    • Under Events, click on Bookings.

    • Under Events with Bookings Enabled, click on the name of the event you wish to view bookings for.
    • To change what information from the booking is displayed, click on the gear icon above the list.

    • Fields in yellow on the left are displayed in the table, and fields in grey on the right are available to be displayed. Click and drag fields from one side to the other to customize your view. Displayed fields are shown in the order they are arranged (top to bottom in the list displays left to right).

    • Click Save Settings to finalize changes. These changes will be saved for this event’s booking table.
    • To export the booking information, click the CSV icon above the list.

    • This brings up the same field organizer. Fields in yellow on the left will be exported to a CSV file in the order they are arranged.
    • Click Export Bookings to save the file.

    Create a Custom Booking Form

    • Under Events, click Forms Editor.

    • To edit an existing form, select it from the Selected Booking Form dropdown. To make a new form, enter a title in the text box and click Add New.

    • Forms must have a Name field (or both a First Name and Last Name field) and an E-mail field. All fields can be customized, rearranged, and deleted.

    • In the Label field, enter the text that users will see accompanying the field.
    • The Field ID is a unique code to distinguish fields. It should be all lowercase, with underscores instead of spaces where necessary. Modifying the Field ID for an existing field can cause the data to not associate with past fields, so only do this if you’re creating a new field.
    • The field Type allows for different data formats. Choose the one most appropriate to the field.
    • Check the Required box if you need the field’s data from every attendee.
    • If you click the gear icon, there are a number of advanced options. The most common one is tip text, which allows you to add a short description or comment to the field.
    • When finished with the form, scroll to the bottom of the table to click Save Form.

    Important Settings

    • Events>Settings>General>User Capabilities
      • This determines what each user can do as defined by their site role.
      • administrator: check all boxes
      • subscriber: check read_private_events and manage_bookings. Read_private_events is necessary because all events published in a private group are private by default.

    • group_leader: check publish_events, edit_others_events, delete_events, edit_events, read_private_events, publish_recurring_events, delete_recurring_events, edit_recurring_events, publish_locations, delete_locations, edit_locations, manage_others_bookings, manage_bookings, upload_event_images

    • These are the only roles that need customizing. All new site users are subscribers by default, and group leaders have to be assigned the role of group_leader as described above.
    • Events>Settings>Emails>Booking Email Templates
      • This can be used to change the emails that are automatically sent out when someone makes a booking.
      • Event Admin/Owner Emails are sent to the event owner and the site admin whenever a booking is made.
      • Booked User Emails are sent to a user when they book an event.
      • These are the global settings – do not use this if you want to make a booking email for a specific event.

    WPForms Plugin

    This covers how to use the WPForms plugin, which is an integrated way to create forms and surveys for the website.

    Create a Form and Options

    • Click on WPForms in the left sidebar. This will bring you to the Forms Overview.
    • Click Add New at the top.
    • Enter a name for your form.
    • Select a template. Blank Form provides you with a totally blank form that you can build any way you need, but other templates have some fields already created to make your project easier. For example:
    • Simple Contact Form has name and email fields and a large comment box for messages.
    • Survey Form has star ratings, a comment box that appears according to feedback, and Likert scales.
    • Next you will be taken to the Fields view. This allows you to add, remove, rearrange, and customize the fields on your form.
    • To add a field, look for it on the left and click and drag it onto the form.
    • To rearrange fields, click and drag them into the correct position.
    • To delete a field, click the trash can icon in the top right corner of the field.
    • To duplicate a field, click on the copy icon in the top right corner of the field.
    • To edit a field, click on it and change the options in the left sidebar.
      • The Label displays above the field.
      • The Description displays in small text below the field.
      • Checking the Required box means that the user must complete the field to submit the form.
      • Different fields may have other options. For example, the Multiple Choice field allows you to add a large list of options (Bulk Add) or use images as choices.
      • See Advanced Options and Conditional Logic below for more information.
    • When you are done constructing your form, click on Settings in the left nav bar.
      • General: edit the form name and description and customize the submit button.
      • Notifications: by default, the site administrator will be emailed whenever a new entry is submitted to a form. Click Add New Notification to add an additional contact.
      • Confirmation: edit the message or action that occurs after a user submits the form.
      • Form Abandonment: checking this allows you to capture the response for a partially filled form if the user leaves before completing it.
      • Post Submissions: allows users to submit a WordPress post via form response. We don’t currently use regular posts on the DME site, but this does include support for custom post types such as forum topics and assignments.
      • Surveys and Polls: Enable Survey Reporting shows cumulative results on the backend in a graphical manner. Enable Poll Results displays cumulative results for all Checkbox, Multiple Choice, and Dropdown fields in a form to the user once they submit the form.
      • Conversational Forms: Creates a page on the site which displays the form questions one at a time and shows a progress bar at the bottom. This can be less distracting or overwhelming for users filling out a long form.
      • Form Locker: restrict when and how users can fill out the form, with password protection, time limit, or entry limit.
      • Form Pages: Creates a page on the site which displays the whole form. This is helpful if you are making a stand-alone form or survey. Without this enabled, the only way to share the form is to embed it on a page with a shortcode (see below).
    • Click Save in the top right corner and the X to exit edit mode.

    Advanced Options for Fields

    • Enable Survey Reporting: shows the cumulative responses for the particular field in a graphical manner on the backend.
    • Field Size: Change the width of the field as it appears to the user.
    • Hide Label: Hides the label on a field. It will still appear in the backend when reviewing entries.
    • CSS Classes: enter snippets of CSS code to customize how the field looks. Click the Show Layouts link to easily organize fields into columns for easier viewing.

    Advanced Options vary based on the type of field. Some other common options are:

    • Placeholder Text (on text fields): text that shows in the field but disappears once the user starts typing their own response. This can be used to show an example of the response format you are looking for; for example, the placeholder text in an email field could be myname@example.com.
    • Default Value: a value that is prefilled on the form when the user opens it.
    • Input Mask: restrict the style of input in a text field. Click the See Examples and Docs link for more details.
    • Randomize Choices (checkboxes and multiple choice): randomize the order the options are displayed in for each user.

    Conditional Logic for Fields

    Enabling conditional logic allows you to set the rules for when a field will be shown or hidden based on the responses in other fields. Some common uses are to show a text box if you select the ‘other’ option in a multiple choice field, or to hide a set of questions if you answer ‘no’ to a particular field.

    For example, consider this form. We want to show the text field only when the user selects ‘Other’ for the first question.

    • Enable Conditional Logic: check for the field(s) you wish to show or hide.
    • Choose to show or hide the field on the condition.
    • In the first dropdown, select the field whose value will affect this field.
    • In the second dropdown, select the criteria for showing/hiding the field.
      • ‘Is/is not’ look for exact matches in the field.
      • ‘Empty/not empty’ apply to text fields.
      • ‘Contains/does not contain’ look for partial matches anywhere in the field.
      • ‘Starts with/ends with’ looks for partial matches at the beginning or end of the field.
      • ‘Greater than/less than’ apply to numeric fields.
    • In the third dropdown, select the value of the affecting field.
    • Here’s the final setup for this example field:
    • You can have multiple conditions affect a field.
      • If you want the field to be shown/hidden when both conditions are true, click the AND button to the right of the first condition and it will add a new ‘AND’ row.
      • If you want the field to be shown/hidden if one or the other is true, click the Add New Group button below the first condition and it will add a new ‘OR’ row.
      • These logic options can be combined in many ways. For example, you can show a field when Condition 1 is met OR both Condition 2 AND Condition 3 are met.

    Export/View Reports

    • To view all the entries for a particular form, hover over the name and click Entries.
    • If survey reporting is enabled, you’ll see a graphical representation of the first question responses and a link to View Survey Results.
    • Below that is a list of all the responses to your form. It shows the first few questions, the status of the response, and the date it was submitted.
      • The circle to the left of each entry is green if the entry has not been viewed yet. You can mark them all as ‘read’ by clicking the Mark All Read link at the top of the page.
      • Click the gear in the top right of the table to change which columns are displayed.
    • To view the entirety of a particular entry, click the View link on the far right. This takes you to a full list of the responses to each entry, along with some details and options for the entry.
    • To export all entries for a form, click Download Export (CSV) at the top of the form’s Entries page. They will be saved as a CSV file, which can be opened/imported into Excel or Google Sheets.
    • To export a particular entry, click View to see the entry and click Export (CSV).

    Shortcodes/Embedding

    There are three ways to get the shortcode for a particular form:

    1. Open it in Edit mode (click on the title or click the Edit link) and click Embed in the top right corner.

      The window that opens displays the shortcode for that particular form at the top.

    2. From the Forms Overview page, look in the Shortcode column for the form you wish to embed.
    3. When editing the page you wish to embed the form on, you can insert a WPForms block and select which form you want to display. This inserts shortcode automatically.
    • Form:
    • Attributes:
      • Id: a unique form identifier. You can find it on the Forms Overview page in the Shortcode column.
      • Title: Boolean. Show or hide the form’s title when embedding.
      • Description: Boolean. Show or hide the form’s description when embedding.

    LearnDash Groups

    LearnDash groups have no front-end access or visibility. A LD group leader can view the members of the group, check and export their progress, and send email notifications to the entire group from the admin panel appropriate to their site access level (dme.childrenshospital.org/wp-admin).

    • For LearnDash group functions, login to the admin panel (dme.childrenshospital.org/wp-admin). On the left sidebar select LearnDash LMS>Group Administration and you will see a list of all the groups you are a leader of.


    • To email a group, click List Users next to the group. At the top of the page, click Email Group.

      Write a subject and your message; you can add media files by clicking Add Media at the top of the Email Message box. Click Send at the bottom of the page when you are finished.
    • Export Progress creates a report of users’ progress through the module, and Export Results creates a report of users’ quiz scores. Clicking on the link prompts you to download a CSV file with the report.
    • To edit the group, click Edit Group. On this page you can control the modules associated with the group, assign group leaders, and add new members to the group. Click Update in the top right to save your changes.