View it on WordPress: (http://wordpress.org/plugins/simple-course-creator/)
Simple Course Creator is designed to easily link posts together in a series and output that series list in the content of each included post.
- Simple Course Creator Customizer
- Simple Course Creator Post Meta
- Simple Course Creator Front Display
Once activated, a new taxonomy is added to your Posts menu called "Courses." Courses are created just like categories and tags.
When creating a new course, it's important to give the course a description as well as a title, which is a new field added by this plugin.
Now with at least one course created, you have the ability to select which course a post belongs to from the edit post screen.
Once a course is selected and saved, a course listing will appear in the content of said post as long as it's not the only post in a course.
The course listing will display as a container that shows nothing but the course title and the course description, which is what you filled out when creating a new course.
The series of posts will be hidden until you click a subtle link for displaying them, at which point the container will gracefully expand to reveal all posts in said course. They will all be linked except for the current post.
Styles are kept to a minimum so theme styles are inherited as much as possible.
Simple Course Creator comes with very simple options.
-
Choose to display your course containers above post content, below post content, both above and below post content , or do not display it at all while still preserving the course configuration.
-
Choose your course list style type. They can be displayed as a numbered list, a bulleted list, or a list with no list indicator at all... simply stacked like paragraphs.
-
Choose to sort your posts by date, author, title, last modified, random, or comment count.
-
Choose to display your sorted posts in ascending order or descending order.
-
Choose a display style of the current post in your post listing. Select between bold, strike, italic, or no style at all.
-
Disable plugin javascript, which causes the post listing to be fully expended on page load. The show/hide function is removed.
Expect more options in the future.
The simplest way to edit your course output is with hooks and filters in your active theme's functions file. SCC comes with built-in hooks littered throughout the output as well as a filter for the course toggle.
Here's a list of all the hook names:
- scc_before_container
- scc_container_top
- scc_below_title
- scc_below_description
- scc_before_toggle
- scc_after_toggle
- scc_above_list
- scc_before_list_item
- scc_after_list_item
- scc_below_list
- scc_container_bottom
- scc_after_container
To use any of these hooks, create your own custom function and use WordPress' add_action() function to call your function with the specific hook location. Here's an example.
function function_name() { ?>
-- custom --
<?php }
add_action( 'scc_container_top', 'function_name' );Pasting that PHP into your active theme's functions file will output "-- custom --" just inside every course container box.
To edit the "full course" toggle link, use the built-in filter course_toggle like so.
function function_name_filter( $toggle ) {
$toggle = str_replace( 'full course', 'complete series', $toggle );
return $toggle;
}
add_filter( 'course_toggle', 'function_name_filter' );With a little CSS usage in your own theme stylesheet, the plugin settings, and the above actions, you can customize SCC however you'd like.
Or...
You are more than welcome to override the basic default styles, behavior, or HTML template responsible for displaying the course container.
If you only want to edit a few CSS styles, you're better off using your own theme's stylesheet and simply writing stronger CSS.
If you would like to override the actual CSS file, JavaScript file, or HTML template for displaying the course container, you can easily do so by creating a folder in the root of your theme called scc_templates and copying any of the files you'd like from the plugin's includes/scc_templates folder into your new theme folder.
Your theme files will now completely override the plugin files.
Be sure to copy these files and not simply create new, empty ones. Even if they're empty, they'll still override.
If you notice any mistakes, feel free to fork the repo and submit a pull request with your corrections. The same is true of any features you feel should be added or changes that can be made.
This plugin, like WordPress, is licensed under the GPL. Do what you want with it. I seriously don't care.
I'm Sean. I've created a few little pieces of software. I'm not that easy to find online. That's by design.
Is this plugin useful to you? If so, please consider buying me a bag of coffee beans. Thank you much. Donate via PayPal