forked from dandelionwebdesign/The-Events-Calendar-Shortcode
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
112 lines (94 loc) · 6.46 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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
=== The Events Calendar Shortcode ===
Contributors: dandelionweb, ankitpokhrel
Tags: event, events, calendar, shortcode, modern tribe
Requires at least: 3.0
Tested up to: 4.1
Stable tag: trunk
Version: 1.0.8
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Adds shortcode functionality to The Events Calendar Plugin (Free Version) by Modern Tribe.
== Description ==
This plugin adds a shortcode for use with The Events Calendar Plugin (by Modern Tribe).
The shortcode displays lists of your events. You can control the event display with the shortcode options.
Example shortcode to show next 8 events in the category festival in ASC order with date showing [ecs-list-events cat='festival' limit='8']
= Shortcode Options: =
* Basic shortcode: [ecs-list-events]
* cat - Represents event category. [ecs-list-events cat='festival, personal’]
* limit - Total number of events to show. Default is 5. [ecs-list-events limit='3']
* order - Order of the events to be shown. Value can be 'ASC' or 'DESC'. Default is 'ASC'. Order is based on event date. [ecs-list-events order='DESC']
* date - To show or hide date. Value can be 'true' or 'false'. Default is true. [ecs-list-events eventdetails='false']
* venue - To show or hide the venue. Value can be 'true' or 'false'. Default is false. [ecs-list-events venue='true']
* excerpt - To show or hide the excerpt and set excerpt length. Default is false. [ecs-list-events excerpt='true'] //displays excerpt with length 100
excerpt='300' //displays excerpt with length 300
* thumb - To show or hide thumbnail image. Default is false. [ecs-list-events thumb='true'] //displays post thumbnail in default thumbnail dimension from media settings.
* You can use 2 other attributes: thumbwidth and thumbheight to customize the thumbnail size [ecs-list-events thumb='true' thumbwidth='150' thumbheight='150']
* message - Message to show when there are no events. Defaults to 'There are no upcoming events at this time.'
* viewall - Determines whether to show 'View all events' or not. Values can be 'true' or 'false'. Default to 'true' [ecs-list-events cat='festival' limit='3' order='DESC' viewall='false']
* contentorder - Manage the order of content with commas. Default to `title, thumbnail, excerpt, date, venue`. [ecs-list-events cat='festival' limit='3' order='DESC' viewall='false' contentorder='title, thumbnail, excerpt, date, venue']
* month - Show only specific Month. Type 'current' for displaying current month only [ecs-list-events cat='festival' month='2015-06']
* past - Show Outdated Events. [ecs-list-events cat='festival' past='yes']
* key - Order with Start Date [ecs-list-events cat='festival' key='start date']
If you like this plugin please rate it on WordPress.org
== Installation ==
1. Install The Events Calendar Shortcode Plugin from the WordPress.og repository or by uploading the-events-calendar-shortcode folder to the /wp-content/plugins directory. You must also install The Event Calendar Plugin by Modern Tribe and add your events to the calendar.
2. Activate the plugin through the Plugins menu in WordPress
== Frequently Asked Questions ==
= What are the shortcode Options: =
= Shortcode Options: =
* Basic shortcode: [ecs-list-events]
* cat - Represents event category. [ecs-list-events cat='festival, personal']
* limit - Total number of events to show. Default is 5. [ecs-list-events limit='3']
* order - Order of the events to be shown. Value can be 'ASC' or 'DESC'. Default is 'ASC'. Order is based on event date. [ecs-list-events order='DESC']
* date - To show or hide date. Value can be 'true' or 'false'. Default is true. [ecs-list-events eventdetails='false']
* venue - To show or hide the venue. Value can be 'true' or 'false'. Default is false. [ecs-list-events venue='true']
* excerpt - To show or hide the excerpt and set excerpt length. Default is false. [ecs-list-events excerpt='true'] //displays excerpt with length 100
excerpt='300' //displays excerpt with length 300
* thumb - To show or hide thumbnail image. Default is false. [ecs-list-events thumb='true'] //displays post thumbnail in default thumbnail dimension from media settings.
* You can use 2 other attributes: thumbwidth and thumbheight to customize the thumbnail size [ecs-list-events thumb='true' thumbwidth='150' thumbheight='150']
* message - Message to show when there are no events. Defaults to 'There are no upcoming events at this time.'
* viewall - Determines whether to show 'View all events' or not. Values can be 'true' or 'false'. Default to 'true' [ecs-list-events cat='festival' limit='3' order='DESC' viewall='false']
* contentorder - Manage the order of content with commas. Default to `title, thumbnail, excerpt, date, venue`. [ecs-list-events cat='festival' limit='3' order='DESC' viewall='false' contentorder='title, thumbnail, excerpt, date, venue']
* month - Show only specific Month. Type 'current' for displaying current month only. [ecs-list-events cat='festival' month='2015-06']
* past - Show Outdated Events. [ecs-list-events cat='festival' past='yes']
* key - Order with Start Date [ecs-list-events cat='festival' key='start date']
= How do I use this shortcode in a widget? =
* You can put the shortcode in a text widget.
* Not all themes support use of a shortcode in a widget. If a regular text widget doesn't work, put the shortcode in a <a href="https://wordpress.org/plugins/black-studio-tinymce-widget/">Visual Editor Widget</a>.
= What are the classes for styling the list of events? =
The plugin does not include styling. Events are listed in ul li tags with appropriate classes for styling.
* ul class="ecs-event-list"
* li class="ecs-event"
* event title link is H4 class="entry-title summary"
* date class is time
* venue class is venue
* span .ecs-all-events
* p .ecs-excerpt
= How do I include a list of events in a page template? =
include echo do_shortcode("[ecs-list-events]"); in the template where you want the events list to display.
== Upgrade Notice ==
= 1.0.7 =
Add options : multi-categories, contentorder, month, past, key
= 1.0.6 =
Fix missing ul
= 1.0.5 =
* Add excerpt and thumbnail - Thanks to ankitpokhrel
= 1.0.2 =
* Add venue to shortcode - Thanks to ankitpokhrel
= 1.0.1 =
* Fix Firefox browser compatibility issue
= 1 =
* Initial Release
== Changelog ==
= 1.0.7 =
Add options : multi-categories, contentorder, month, past, key
= 1.0.6 =
Fix missing ul
= 1.0.5 =
* Add excerpt and thumbnail - Thanks to ankitpokhrel
= 1.0.2 =
* Add venue to shortcode - Thanks to ankitpokhrel
= 1.0.1 =
* Fix Firefox browser compatibility issue
= 1 =
* Initial release