-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathreadme.txt
91 lines (60 loc) · 3.14 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
=== Random Content ===
Contributors: endocreative
Donate link: http://www.endocreative.com
Tags: content, widget, random, shortcode, text, images, testimonials, faq
Requires at least: 3.0.1
Tested up to: 4.5.3
Stable tag: 1.3.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Randomly display any content anywhere on your site.
== Description ==
This plugin allows you to display random content anywhere on your site using a shortcode or widget. You can group your random content together, allowing you to display different content in multiple locations throughout your site.
The content is added via a custom post type, so you have full access to the tinyMCE editor. This allows you to easily add images, text, and links to your random content.
= Using a widget =
1. Navigate to Appearance->Widgets and add the Random Content widget to a sidebar.
2. Select a group from the dropdown. If you don't create a group, the widget will use all entries.
= Using a shortcode =
Place the shortcode `[random_content]` anywhere on a post or page.
To choose entries from a specific group, add the `group_id` parameter. For example, `[random_content group_id="64"]`.
To specify the number of posts to show, add the `num_posts` parameter. For example, `[random_content group_id="13" num_posts="3"]`.
== Installation ==
1. Upload `random-content.php` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Create an entry in the Random Content post type.
4. Categorize your content using Groups.
**Only content within the content editor will be displayed.**
== Frequently Asked Questions ==
= Can I group certain entries together? =
Yes. Create a group, and assign specific entries to the group. It works just like categories.
= How do I find the group id? =
Click on Random Content > Group in the WordPress admin. Look for the number in the ID column.
= How do I display more than one post? =
In the shortcode, use the num_posts parameter. In the widget, enter a number in the "Number of Posts to Show at Once" input.
== Screenshots ==
1. Adding the widget to a sidebar.
== Changelog ==
= 1.3.1 =
* Fix shortcode output so that multiple posts will display
= 1.3 =
* Add rc_content filter for extending the plugin output in both the shortcode and the widget
* Add content filter to widget output to allow for oembed support
= 1.2 =
* Add localization files for translation support
= 1.1 =
* Add num_posts parameter to old version of shortcode for backwards compatibility
= 1.0 =
* Update shortcode to [random_content] to help prevent conflicts with other plugins
* Added a num_posts paramenter to the shortcode so that more than one post can show at a time
* Added the ability to not choose a group in a widget, even if a group exists
* Added the ability to control the number of posts that show in the widget
* Rebuilt the plugin using OOP principles based on the WordPress plugin boilerplate
* Added plugin banner graphic
* Updated screenshot image
= 0.4 =
* Update input text syntax in widget
= 0.3 =
* Add shortcode functionality.
* Reset post data after widget query.
= 0.1 =
* First released into the wild.