readme.txt

=== Design Upgrade for LearnDash ===
Contributors: escapecreative, davewarfel
Donate link: https://www.paypal.me/escapecreative/10
Tags: learndash, lms, learning management system, online courses, css
Requires at least: 4.6
Tested up to: 5.5
Requires PHP: 5.6
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Instantly improve LearnDash's design -- focus mode, course content, profile page, course navigation & course grid -- to more closely match your WordPress theme, and improve LearnDash styles.

== Description ==

LearnDash is a powerful learning management system (LMS) for managing your online courses, but there are some areas where the design falls short. In order to provide your students with an exceptional learning experience, you need a professional design.

### Enter Design Upgrade for LearnDash

Design Upgrade for LearnDash completely redesigns every aspect of LearnDash so that it closely resembles your existing WordPress theme. No settings or custom code. Just activate & enjoy!

### Compatible with LD3 & "Legacy" Templates

We'll automatically detect whether you're using the "LearnDash 3.0" or "Legacy" template, and assign styles appropriately. If you're still running LearnDash 2.x, all of the same design upgrades that you've always enjoyed will still be there.

See below for a list of what's new.

### Features

**LearnDash 3.x Features**

Tested with LearnDash 3.2.2

* **NEW:** Major design improvements for WisdmLabs' LearnDash Group Registration plugin
* **Focus Mode:** Improved styles for Focus Mode comments, which were added in LearnDash 3.1
* **Global:** Larger clickable areas for all course content, navigation & Focus Mode areas
* **Buttons:** All buttons have matching rounded corners & increased font size
* **Font Sizes:** These will now be inherited from your theme, which should increase your font sizes across the board
* **Focus Mode:** Improved sidebar tray design, Course Sections, shadow added to mobile menu, collapse arrow flips to show current menu state, and more.
* **Focus Mode:** Top navigation bar received several small improvements
* **Animations:** Subtle animations for LearnDash tooltips & the Focus Mode top menu
* **Profile:** Several styles were improved & standardized
* **Login/Registration:** Unified styles for all form fields
* **Course Grid:** Equal height columns & other small tweaks
* **WisdmLabs Ratings, Reviews & Feedback** design upgrades

**Also:** Small tweaks were made to assignments, pagination, the "User Status" widget and more.

**LearnDash 2.x "Legacy" Features**

Tested with LearnDash 2.6.6

* Much improved course grid styles, equal height cards & no more weird spacing issues 👍
* All fonts have been reset to use your theme's default font family, size & color
* All PNG icons have been replaced with comparable SVGs
* All complete/incomplete icons for lesson/topic/quiz lists have been moved to the right for better consistency
* Spacing around & between elements has been adjusted to provide greater consistency throughout
* All LearnDash widgets now have more consistent spacing & sizing, including improvements to Course Info & Course Navigation
* Styling for the `[ld_profile]` shortcode has been completely revamped
* Completely revamped & restyled quiz elements 💯
* Improved design of the statistics modal window (for quizzes), including row highlights on hover
* Larger pager navigation buttons to improve usability
* Full support for RTL languages

### Who is this for?

**Brand new LearnDash users:** There is absolutely no reason not to try it out. At the very least, it will give your site a more consistent design. If you plan to customize LearnDash further, you can still do so using a child theme or Additional CSS in the Customizer.

**Seasoned LearnDash veterans:** If you have not made any customizations to your LearnDash design, but would like to improve it, give us a shot. You might want to try it out on a test site first, but you can deactivate it with one click and return to your previous design.

You might also want to give your students a heads up that you're updating the design. But we feel confident that they'll like it :-)

**LearnDash developers:** If you're a developer who builds LearnDash sites for your clients, this could save you hours (maybe even days) of development time. LearnDash's markup & CSS is a beast to customize. This will give you a much easier baseline to work with.

We designed the plugin to be just specific enough to override LearnDash's default styles, but not so specific that you'll need to use a ton of selectors to override our specifity. All CSS in child themes and Additional CSS will take precedence over our styles.

### Pro Version

**Need custom styles?** Our [pro version](https://escapecreative.com/products/design-upgrade-learndash/?utm_source=wordpress.org&utm_medium=free%20plugin&utm_campaign=readme) uses the Customizer to bring you **over 110 customizable design options.** Completely customize your LearnDash site with just a few clicks.

https://www.youtube.com/watch?v=hOUToX87U9E

#### Pro Features

* Show/Hide various course & profile features
* Disable expand/collapse links & show all by default
* **Course Content Lists:** Update background & text colors, hover effects, customize line separators, remove the list count numbers and more
* **Progress Bar:** Customize the color, border radius & height, add stripes, and animate the bar on page load
* **Buttons:** Add your own background & text colors
* **`[ld_profile]`:** Avatar shape, custom "edit profile" link, hide profile info, hide quiz information, and more
* **Login/Registration Popup:** 10+ design options
* **Focus Mode:** 20+ design options, including 7 for Focus Mode comments
* **Course Navigation Widget:** 15+ design options
* **Course Grid Add-On:** 20+ design options
* **Alerts:** 9 custom colors, plus a few other options
* **Tooltips:** customize the background & text color
* **Uncanny Groups:** buttons, border radius & improved styles are applied to many Uncanny Groups frontend elements
* **Tin Canny Reporting:** 12+ design options for Tin Canny reports on the front-end

**[Upgrade to Pro Today »](https://escapecreative.com/products/design-upgrade-learndash/?utm_source=wordpress.org&utm_medium=free%20plugin&utm_campaign=readme)**

### Theme Compatibility

Design Upgrade for LearnDash **should work on most themes**, assuming they have not customized the LearnDash markup in any way. While we can't guarantee full compatibility, we have tested with the following themes.

#### Tested With

We have tested with the following themes, and they all appear **to be compatible:**

* Astra
* Divi
* GeneratePress
* eLumine (when using the "LearnDash 3.0" active template or eLumine's "Elementary Layouts")
* LearnMate
* Edufire
* Neve
* OceanWP
* Storefront

#### Incompatible Themes

* BuddyBoss Platform (released June 2019)
* Boss. / Social Learner (If you deactivate the "Boss for LearnDash" plugin, it will still work in "Legacy" mode)
* eLumine (when using the "Legacy" active template or any version of LearnDash before 3.0)

#### Incompatible Plugins

* **LearnDash Visual Customizer by SnapOrbital:** The Visual Customizer takes a similar approach to designing LearnDash components, and thus the code conflicts with ours.

### Uncanny Owl Toolkit Compatibility

We recognize the [Uncanny LearnDash Toolkit](https://wordpress.org/plugins/uncanny-learndash-toolkit/) by Uncanny Owl is a popular LearnDash plugin that adds some nice features. We're in the process of making our plugin fully compatible with theirs. Here's where we are so far:

* Reset Progress button: Button styles upgraded
* Simple Course Timer modal: Button styles upgraded
* `[uo_dashboard]`: Styles upgraded
* `[uo_courses]`: Styles upgraded
* `[uo_breadcrumbs]`: Compatible; Considering upgrades
* `[uo_lessons_topics_grid]`: Compatible; Considering upgrades
* `[uo_login_ui]`: Compatible; Considering upgrades

**NOTE:** Uncanny LearnDash Toolkit styles are only upgraded if you're using the "LearnDash 3.0" active template. Styles do not apply to the "Legacy" template.

### Plugin Compatibility

#### Ratings, Reviews & Feedback plugin by WisdmLabs

As of version 2.5, we now enhance the styles of the Ratings, Reviews & Feedback plugin by WisdmLabs. For a detailed overview, please see our [article on ldx.design](https://ldx.design/design-upgrade-wisdmlabs-ratings-reviews).

#### Group Registration plugin by WisdmLabs

As of version 2.6, we now enhance the styles of the Group Registration plugin by WisdmLabs. General design improvements will be made to all frontend elements output by the `[wdm_group_users]` shortcode.

### Browser Support

A few techniques we use to improve the LearnDash design are only supported in the latest versions of major browsers. For the most part, as long as you're **not** using Internet Explorer, most (if not all) of our plugin's design upgrades will work.

We support the latest versions of the following browsers:

* Google Chrome
* Mozilla Firefox
* Apple Safari
* Microsoft Edge
* Chrome for Android
* Firefox for Android
* iOS Safari (not tested, but should work)

We **do not** support any version of Internet Explorer, however, we do offer a few code snippets & suggestions to fix a few issues in IE11. See the IE11 section below in FAQ.

### Roadmap

As LearnDash adds new features, it is our goal to keep this plugin updated.

Features planned for future release:

* Compatibility with more Uncanny LearnDash Toolkit modules

#### We'd love to hear from you!

Does something look weird with your theme? Is there something we missed? Wouldn't it be cool if...

We tested it on a handful of popular themes, but we couldn't possibly cover them all. If you have any feedback, please let us know in the [support forum](https://wordpress.org/support/plugin/design-upgrade-learndash).

#### Credits

* Paint brush icon made by [Freepik](http://www.freepik.com), courtesy of [flaticon.com](https://www.flaticon.com/). Licensed under [CC3.0 BY](http://creativecommons.org/licenses/by/3.0/).
* Gradient by [colorful gradients](https://colorfulgradients.tumblr.com/post/155121898640/colorful-gradient-43352)

== Installation ==

=== From within WordPress ===

1. Visit "Plugins > Add New"
1. Search for "Design Upgrade for LearnDash"
1. Click the "Install" button
1. Click the "Activate" button
1. There are no settings to configure. An improved design will automatically be applied to all LearnDash elements on your site.

== Frequently Asked Questions ==

= Where are the settings? =

The free version doesn't have any. It simply applies a fresh coat of paint behind the scenes.

Check out our [pro version](https://escapecreative.com/products/design-upgrade-learndash/?utm_source=wordpress.org&utm_medium=free%20plugin&utm_campaign=readme&utm_content=faq) that includes 100+ settings you can customize.

= Will this affect the rest of my site? =

No. We've carefully crafted it to only apply to LearnDash elements. The rest of your site (header, footer, pages, blog posts, etc.) will continue to use the styles determined by whichever WordPress theme you are using.

= Can I use this plugin with the LearnDash Visual Customizer? =

Technically, yes, but you will encounter some weird design issues. We recommend you check out our similar [pro plugin](https://escapecreative.com/products/design-upgrade-learndash/?utm_source=wordpress.org&utm_medium=free%20plugin&utm_campaign=readme&utm_content=faq) to customize LearnDash styles.

= Is this compatible with the Elementor for LearnDash Integration? =

The general design & UX improvements that Design Upgrade makes will still take effect. However, any customizations you make to LearnDash elements in Elementor will override our plugin's styles.

But yes, you can use the two together without any issues.

= Can I use this plugin with the Divi LearnDash Kit? =

I have done some testing with the Divi LearnDash Kit, but I haven't tested every element. It should work in most cases, but you'll want to test all your pages. If you find something that isn't compatible, please let us know in the [support forum](https://wordpress.org/support/plugin/design-upgrade-learndash) so we can fix it.

= Can I make design changes in addition to what the plugin makes? =

Absolutely. Feel free to add your own CSS if you want to further customize the look & feel of your LearnDash site. Just place your CSS in a child theme or the Additional CSS area of the WordPress Customizer. Or check out our [pro plugin](https://escapecreative.com/products/design-upgrade-learndash/?utm_source=wordpress.org&utm_medium=free%20plugin&utm_campaign=readme&utm_content=faq).

= Will this slow down my site? =

No. We do add one CSS file to the header, but as long as you're using a reliable WordPress host with decent performance, you shouldn't notice a difference.

= IE11 Support & Bug Fixes =

The two main CSS features we use that cause issues in IE11 are CSS custom properties (variables) and flexbox. You can use the following CSS to fix some of these issues if you're using IE11.

To fix some layout issues with the course grid:

`.ld-course-list-items div.ld_course_grid .thumbnail.course {
	display: block !important;
}

.ld-course-list-items div.ld_course_grid .thumbnail.course .caption {
	display: block;
}`

To fix colors not appearing, you'll need to use the dev tools to look for all CSS properties that start with `var(--`. These represent CSS custom properties, and they don't work in IE11.

For example, replace `var(--ldx-color-link)` with `#000000`, or whatever hexadecimal color value you'd like to use for your link color.

= My course/lesson/topic/quiz still looks weird. Can you help? =

Most likely, yes. We'll certainly try.

We designed this plugin to be flexible so that it takes on many of the characteristics of your WordPress theme. But every theme is built differently, so styles will differ from site to site. Shoot us a message in the [support forum](https://wordpress.org/support/plugin/design-upgrade-learndash) with a link to your site and we'll try to help out.

== Screenshots ==

1. Much improved styles for the course grid add-on, including equal-height columns
2. Updated quiz styling for every question type
3. More usable sidebar navigation with larger clickable areas
4. Consistent spacing & more subtle "Reply" buttons for Focus Mode comments
5. Simplified & cleaned up the `[ld_profile]` shortcode/block

== Changelog ==

= 2.7.1 - October 11, 2020 =

- Tweak: Focus Mode: Slightly reduced font size in sidebar navigation
- Tweak: Progress Bar: "% Complete" was off-center on mobile devices
- Tweak: Lesson/Topic Timer now inherits text color
- Tweaks: CSS updates for compatibility with LearnDash 3.2.3.3 (see below)
- Tweak: Focus Mode: Header content action buttons spacing/layout
- Tweak: Focus Mode: Sidebar Navigation: Removed rotation on collapse arrow because LearnDash is now including it

= 2.7 - July 20, 2020 =

- New: Slight improvements to the `[ld_group_list]` grid output
- New: Slight improvements to the Group Courses List output
- Tweak: A few small adjustments to help with Pro features for Groups

= 2.6.5 - May 15, 2020 =

- New: eLumine theme: A few design upgrades for the course grid
- New: eLumine theme: Adjusted styles for progress bar in course grid
- Fixed: Width adjustment on buttons within LearnDash alert messages
- Tweak: More specific CSS selectors for buttons in course grid
- Changed: Focus Mode Sidebar: Adjusted sizing of calendar/unlock icons for drip/sample lessons so the icon fits better inside of the circle

= 2.6.4 - April 29, 2020 =

- Added: Framework for new Tin Canny Reporting styles in the Pro version

= 2.6.3 - April 4, 2020 =

- Fixed: Quizzes: Proper correct/incorrect highlighting for cloze (fill in the blank) questions

= 2.6.2 - March 26, 2020 =

- Fixed: Width adjustment on buttons within LearnDash alert messages
- Tweak: Course Grid: Adjusted CSS to account for issues on some sites using the SG Optimizer plugin to combine CSS files

= 2.6.1 - March 7, 2020 =

- Compatibility: Updated styles to fix a few small issues with LearnDash 3.1.4 (very minor)

= 2.6 - February 21, 2020 =

- Integration: Upgraded styles for [WisdmLabs Group Registration](https://wisdmlabs.com/group-registration-for-learndash/) plugin
- Changed: Course Navigation: Removed background color on inner lesson `<div>` tag
- Changed: Focus Mode: Progress Bar: Increased space between bar & "% Complete"
- Fixed: RTL: Focus Mode sidebar close icon positioning
- Fixed: RTL: Focus Mode "Mark Complete" checkmark icon overlap
- Removed: Transition styles on tooltips because they were conflicting with default LearnDash behavior
- Tweak: Updated CSS animation names to avoid theme/plugin conflicts

= 2.5.1 - January 14, 2020 =

- Fixed: Course Grid Video Previews: Border radius now works properly for top corners
- Changed: Course Grid Video Previews: Black background color added behind video embeds
- Changed: Font sizes & weights of several elements within the `[ld_profile]` summary section
- Added: Framework for a few more profile styles in the Pro version

= 2.5 - January 8, 2020 =

- Integration: Upgraded styles for WisdmLabs Reviews, Ratings & Feedback Plugin ([learn more](https://ldx.design/design-upgrade-wisdmlabs-ratings-reviews/))

= 2.4.3 - December 30, 2019 =

- Added: Max-width for the login & registration forms so they don't stretch all the way across larger screens
- Removed: Styling on Focus Mode logo images that was causing some taller logos to expand beyond the header area
- Tweak: Login/Register Buttons: Slightly reduced the opacity of the shadows on hover

= 2.4.2 - December 17, 2019 =

- Added: CSS compatibility for upcoming Widget Areas for LearnDash plugin

= 2.4.1 - November 25, 2019 =

- Added: Class name (`.ldx-grid-course-complete`) is applied to completed courses in the course grid
- Tweak: Quiz Results: Added spacing between paragraphs & lists in the quiz response message displayed on the results page
- Compatibility: Hello Elementor: Improved styles for better compatibility with the Hello Elementor theme
- Fixed: Single & Multiple Choice Questions: When an answer is answered incorrectly, the correct answer is highlighted in green (bug introduced in LD 3.1 with a class name change)
- Fixed: Tooltip alignment

= 2.4 - November 20, 2019 =

- Added: Improved styles for Focus Mode comments
- Fixed: Quizzes: Matrix sorting questions spacing issues
- Tweak: Quizzes: Matrix sorting questions use a slightly different style when viewing correct/incorrect answers after a quiz

= 2.3 - September 23, 2019 =

- Added: Uncanny LearnDash Toolkit Pro: The Simple Course Timer idle timeout modal now uses consistent button styles
- Added: Uncanny LearnDash Toolkit Pro: The "Reset Progress" button now uses consistent button styles
- Added: Uncanny LearnDash Toolkit Pro: Many `[uo_dashboard]` elements now inherit LearnDash default styles, buttons & colors
- Added: Uncanny LearnDash Toolkit Pro: The `[uo_courses]` enhanced course grid now matches the style of the LearnDash Course Grid add-on.
- Updated: A handful of small improvements for quizzes

= 2.2.1 - August 25, 2019 =

- Added: Improved styles for the Course Status area at the top of course pages (for non-enrolled users)
- Added: Focus Mode: Brand logo no longer gets squished on medium-sized devices

= 2.2 - August 23, 2019 =

- Added: Button styles for Login/Logout button when using the `[learndash_login]` shortcode
- Added: Login/Registration Modal: Close Icon: Increased size & added hover effect
- Added: Login/Registration Modal: More consistent `<input>` styles
- Added: Login/Registration Modal: Improved button styles
- Added: Framework for adding custom login/registration styles into Pro
- Fixed: Icon spacing for "Download Certificate" button

= 2.1.3 - July 5, 2019 =

- Added: Compatibility for RTL languages
- Added: Framework for adding custom alert styles into Pro
- Fixed: Alert icon position on smaller screens

= 2.1.2 - Jun 26, 2019 =

- Added: Framework for adding custom ribbon colors back into Pro

= 2.1.1 - Jun 24, 2019 =

- Added: Alerts: Vertically center all icons
- Added: Focus Mode: Small improvements to spacing of username in header
- Added: Improved styles when "Mark Complete" button is disabled
- Fix: Add space for "Download Certificate" button icon, and other small tweaks to buttons within alerts
- Tweak: More specific button style to avoid some theme conflicts with link colors

= 2.1 - Jun 22, 2019 =

- Added: Many more CSS custom properties, preparing for Pro version release
- Added: Course Grid styles are back: equal height columns & other small improvements
- Added: Stop images from overflowing outside the answer label area when used in single & multiple choice quiz questions (props [Anthony](https://perfectmymusic.com/))

= 2.0.1 - Jun 10, 2019 =

- Added: Styles for Uncanny LearnDash Toolkit Resume button
- Fixed: Updated all font sizes for broader theme compatibility (specifically with OceanWP)
- Tweak: Removed more empty `<p>` tags that are output with some LearnDash widgets
- Tweak: A few other minor adjustments for broader theme compatibility

= 2.0 - Jun 7, 2019 =

- NEW: Now compatible with the "LearnDash 3.0" Active Template
- NOTE: We're still compatible with LearnDash 2.x, as well as the "Legacy" template, but there are no changes for those versions. All future development will be focused around the new design.

= 1.4.8 - Mar 23, 2019 =

- Changed: Course Grid: Buttons are now displayed at the very bottom of each grid item.

[View full changelog →](https://github.com/escapecreative/design-upgrade-learndash/blob/master/changelog.txt)