-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
148 lines (116 loc) · 10.6 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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
=== Add infos to The Events Calendar ===
Contributors: hage, threadi
Tags: The Events Calendar, events, shortcode, button, lightweight
Donate link: https://haurand.com/wordpress-plugins/
Requires at least: 4.0
Tested up to: 6.7
Requires PHP: 7.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Stable tag: 1.5.1
“Add infos to The Events Calendar” provides a shortcode block to single events for The Events Calendar Free Plugin (by MODERN TRIBE)
== Description ==
The lightweight plugin “Add infos to the events calendar” provides a shortcode block (image copyright, button with link to events with a special category, link to the website of the organizer) to single events for The Events Calendar Free Plugin (by MODERN TRIBE)
The path to The Events Calendar (TEC) categories is automatically suggested during installation. To be on the safe side, however, you should check this by going to the relevant event after using the shortcut and checking that the links are executed correctly.
As a rule, the short code (description and examples see below) should be one of the last lines of a single event. However, the short code can also be used in principle in posts. In this case, you should usually not use the option "vl", because this option refers to events, unless you want to link to a specific category in a contribution on events, for example.
Automatically displays the text from "Caption" (see Media, image details) in italics by default for an event or a post. A copyright notice should be entered in this field.
= Attention =
If the plugin is deleted, the shortcode remains in the posts and events. In this case use a plugin to delete the shortcodes, e.g. Shortcode Cleaner Lite (see wordpress.org). However, there is no guarantee that all shortcodes will be deleted correctly.
= Shortcode - Options =
1. link = link e.g. to organizer
2. vl = list of events
3. il = e.g. used for internal link
= Call Examples =
* [fuss link="https://externer_link.de" vl=""] --> always shows picture credits, then more info with the link to external website and at vl="" the link to "more events".
* [fuss vl=""] --> always shows picture credits, but no link to external website and at vl="" the link to "more events".
* [fuss] --> always shows picture credits, but no link to external website.
* [fuss link="https://externer_link.de" vl="nature"] --> always shows picture credits, then more info with the link to external website and at vl="Nature" the link to "more events: nature".
(of course the category must exist in The Events Calendar (this is checked by a function). If the category does not exist, the event list will be shown.)
* [fuss vl="" il="http://internal_link.de/example"] --> always shows picture credits, but no link to external website and at vl="" the link to "more events" and at il="http://internal_link.de/example" the link to another external or internal webesite.
https://youtu.be/j9dj3uoacxI
== Installation ==
1. Download "add_infos_to_the_events_calendar.zip" to your local device.
2. Unzip the file.
3. Upload the folder "add_infos_to_the_events_calendar" to "/wp-content/plugins/"
4. Activate the plugin through the "Plugins" menu in WordPress.
https://youtu.be/j9dj3uoacxI
== Frequently Asked Questions ==
= Who will answer my support request? =
A developement staff member of haurand.com.
= Is it possible to use this plugin also for other event plugins or without any event plugin? =
Basically, this plugin can only be used if The Events Calendar is also activated. Of course, you can check if the plugin can also be used if you use another plugin for events. In this case I would be very happy about your feedback, because I would like to include this information in the description here.
If no Events plugin is used, the plugin can only be used to display the copyright and external as well as internal links via the shortcode.
= Are the shortcodes deleted when the plugin is deleted ?
No, if the plugin is deleted, the shortcode remains in the posts and events. In this case use a plugin to delete the shortcodes, e.g. Shortcode Cleaner Lite (see wordpress.org). However, there is no guarantee that all shortcodes will be deleted correctly.
= Where can I find the path to the categories of The Events Calendar ?
When installing the plugin, the path to the categories of TEC is automatically recognized by the plugin. Under the heading you will see the following hint:
"This could be the path to the categories of The Events Calendar (TEC): (URL)
To be on the safe side, however, you should check this by going to the relevant event after using the shortcut and checking that the links are executed correctly."
If the suggested path is not correct, you can proceed as follows:
Select "Events" -> "Event Categories" from the menu. You will then see the categories on the right. Move the cursor to "View" of a category and copy the URL e.g. with CTRL C. Then you will get e.g. the following URL: http://beispielseite.de/events/category/lesungen/
Then copy the URL in the settings of "Add Infos to the events calendar" into the field with the path, but without the category (lesungen), so that you get the following URL for the example: http://beispielseite.de/events/category/
= Why did I develop this plugin ?
It is extremely important to note the copyright notice in the text of photos. I had always done this by copying and pasting the caption from the featured image, but I'd already forgotten it.
The Shortcodes gets this information automatically from this field. I also wanted to place some additional and more visually appealing buttons. This is now also possible with the plugin (see examples).
= What about the further development of the plugin ?
great question :-)
I already have some more ideas and can tell you that this plugin will definitely be further developed and get some additional features. An important aspect will be that the plugin remains lightweight. If you have any suggestions for further development, I would be very happy if you could tell me. Answer guaranteed, but I can't guarantee that your ideas will be implemented ;-)
= Where can I donate for this plugin?
Nowhere - but a donation to a charity that needs the money more urgently than I would be great. But I would be very happy about a positive review.
= Is it possible to customize the button labels ?
Yes, from version 1.0 on this option is new, see Settings and Changelog
= Add infos to the events calendar and SEO
By the way, we have found using of the plugin has positive effects in terms of SEO, i.e. findability and ranking on Google.
This is also logical because important factors are covered by the plugin:
The input of an internal and external link as well as the specification of a category when using TEC are very important with regard to SEO.
In addition, the plugin also encourages you to put more emphasis on creating appropriate input like alternative text for the photo or image.
As you know, several terms can be entered here.
In addition, we could notice a significant increase in the number of pages per visitor,
which is also related to the fact that the corresponding buttons are clicked more often at events and contributions.
As a rule, if the categories or internal and external links are carefully selected, it is possible to make visitors curious about further information and click on these buttons.
== Screenshots ==
1. All options in the settings
2. Representation of the event in the frontend
3. Use in a single event (backend)
4. The reference to the photo must be entered in this field (caption).
5. Call via the icon at the top right of the menu bar. Then click on "Add Infos to the events Calendar".
6. These fields can currently be filled automatically via the shortcode generator and then appear in the description at the point where the cursor was positioned.
7. Executing the Shortcodes in Gutenberg
== Changelog ==
= [1.5.1] 2024-12-08
* Fixed potential error during loading of settings
= [1.5.0] 2024-11-30 =
* Compatible with WordPress Coding Standards
* Only compatible with PHP 7.4 or newer (incl. PHP 8.4)
* Updated translations
= [1.4.1] 2021-04-05 =
* Enhancement: Improved and secure call for external links and improvement related to Web Vitals.
= [1.4] 2020-02-15 =
* Added feature: If using Classic Editor or Classic Block (Block Editor): After clicking on Icon "Add infos to the events calendar" it is possible to choose a category from the select box. Thanks to Adrian Lambertz from https://pixelbar.be for his great help implementing this option.
* Added feature: Settings: Now you can choose whether the categories should be sorted by frequency (default: frequently selected categories first) or by category name.
* Added: Even if The Events Calendar or any other event plugin is not installed, this plugin can be used without problems. Now only the options that are necessary in this case are shown.
* Updated translations
= [1.3] 2019-05-30 =
* Fixed: Problem with the version number (1.2) so that no updates are performed automatically from Version 1.02 to 1.2.
= [1.2] 2019-05-28 =
* Added: Icon added to the editor tinycme (Classic Editor), so that now the entries for the internal and external link no longer only have to be entered manually directly as short code, but via an additional dialog. This option can be used in the Gutenberg Editor (Block Editor: Classic).
= [1.02] 2019-05-18 =
* Fixed: If The Events Calendar is not installed, in some cases an error message appeared on the page with the short code
* Added: Automatically adds http:// to a URL before the link, if that is missing
= [1.01] 2019-05-14 =
* Fixed: With the option "vl" the event list was not displayed correctly if the category was wrong or vl="" was selected.
= [1.0] 2019-05-14 =
* Added feature: The name of the buttons can now be defined via the settings. It is no longer necessary to have translation files that contain translations of the button names.
* Added: Display the copyright only if the field is not empty
* Updated translations
* Updated design of the settings
= [0.66] 2019-05-10 =
* Add some infos and update language files
= [0.65] 2019-05-09 =
* Fixed a bug with the language files
= [0.62] 2019-05-07 =
* Initial release
== Upgrade Notice ==
= [1.0] =
* Please have a look at the settings, because from this version on there are settings for the <strong>labeling of the buttons</strong>. This allows the buttons to be labeled individually and you are no longer dependent on whether a translation is available in the respective language file.
* If the translations are not correct, you have to look into the folder wp-content\languages\plugins and delete the existing translation files add-infos-to-the-events-calendar*.* if necessary. <strong>Attention</strong>: Please always make a backup first.