-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
175 lines (125 loc) · 7.8 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
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
=== Spaces Global Tags ===
Contributors: neverything
Tags: multisite, wpmu, taxonomies
Requires at least: 4.5
Tested up to: 5.4.1
Stable tag: 0.22.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Adds global tags for posts and comments in a multisite installation. Uses the [Multisite Taxonomies](https://github.com/dol-lab/multisite-taxonomies) plugin
to create taxonomies.
== Description ==
This plugin relies on the [Multisite Taxonomies](https://github.com/dol-lab/multisite-taxonomies) plugin to perform network wide queries. Adding and managing taxonomies in the network admin.
Spaces Global Tags creates two new multisite taxonomies. Both taxonomies are assigned to the `post` post-type. The first one `global_comment_tags` is storing `#tags` made in comments on the post. The second one `global_post_tags` allows post authors to create `#tags` while writing posts.
When using the frontend editor provided by [Spaces](https://kisd.de/en/spaces) it shows an autocompletion for existing tags and allows you to create new ones on the fly.
Other notable features:
* Global Tag archive pages `https://example.com/multitaxo/<taxonomy_name>/<tag_slug>`
* Global Taxonomy archive pages `https://example.com/multitaxo/<taxonomy_name>/`
* Allow tagging in the P2 style aka adding `#foo` in the `post_content` and `comment_text`.
== Installation ==
Clone it, love it, hate it.
1. Install the [Multisite Taxonomies](https://github.com/dol-lab/multisite-taxonomies) and network activate it.
2. Install this plugin and network activate it.
3. Find the taxonomies in the network admin.
== Frequently Asked Questions ==
= Does this replace the default tags in a WordPress multisite =
No. But it does disable them on the `post` object type.
= Is there a global search available =
No, not yet. It will be integrated with the Spaces search, but for now you will have to click on the tags to reach the archive pages.
= I found a bug, where can I report it? =
Please check if the bug is already mentioned on the Github repository or [create a new issue](https://github.com/dol-lab/spaces-global-tags/issues).
= Can it do X, could you add Y? =
For feature request, please head over to the [Github repository](https://github.com/dol-lab/spaces-global-tags/) and create a feature request or a pull request with your proposed feature.
We can't guarantee to build or merge your feature request, so consider creating a companion plugin using the filters provided by our plugin.
= Can I extend or change the behaviour of the plugin? =
Certainly, we provide a bunch of useful hooks and so does the [Multisite Taxonomies](https://github.com/dol-lab/multisite-taxonomies) plugin.
* Filter `spaces_global_tags_archive_template_path`, change the path to the archive page template, default: `plugin_dir_path( __DIR__ ) . templates/template.php`.
* Action `spaces_global_tags_below_archive_title`, change what is displayed below the archive title, defaults to related tags of the same taxonomy.
* Filter `spaces_global_tags_post_types`, change the post types using the global taxonomies, defaults to `[ 'post' ]`.
* Filter `spaces_global_tags_user_roles`, change the roles allowed to create and add tags, defaults to `[ 'administrator', 'editor', 'author' ]`.
* Filter `spaces_global_tags_user_capabilities`, change the capabilities granted to the mentioned roles, defaults to `[ 'manage_multisite_terms', 'edit_multisite_terms', 'assign_multisite_terms' ]`.
* Filter `spaces_global_tags_archive_path`, change the default path for the archive pages. In the context of spaces it's `/home/` otherwise the main network site.
* Filter `spaces_global_tags_found_tags`, allows you to change the found tags in a text string (`post_content`, `comment_text`), defaults to array of found tags.
* Filter `spaces_global_tags_tag_link`, allows you to change the link destination for the tag archive page.
* Filter `spaces_global_tags_number_of_related_tags`, allows you to change the number of other tags shown in the same taxonomy, default is `30`.
* Filter `spaces_global_tags_show_link_to_all_tags`, whether we show a link to all tags in a taxonomy on a term archive, default is `true`.
* Filter `spaces_global_tags_term_cloud_args` allows changing of the args passed to the tag cloud widget.
== Screenshots ==
== Changelog ==
= 0.22.3 =
* Code styling and typos in comments.
* Fix permalinks for global archive page in Spaces installs, fixes https://github.com/dol-lab/spaces-global-tags/issues/36
= 0.22.2 =
* Spring cleaning: Replace hard-coded strings with existing constants.
* Remove invalid dependency check on plugin activation.
* Add dependency check for plugin activation and load, fixes https://github.com/dol-lab/spaces-global-tags/issues/34
= 0.22.1 =
* Disable comment tags for now, will add them again later when comment editor is more mature.
= 0.22.0 =
* Add proper plugin description to plugin header.
* Format changelog
= 0.21.0 =
* Add checkbox to widget form, to display link to taxonomy archive.
* Display link to taxonomy archive, if checkbox is checked.
= 0.20.0 =
* First version of the global tag cloud widget.
= 0.19.0 =
* Show link to all tags in a taxonomy on the term archive page.
* Display posts per term on term archive page.
* Display posts per term on taxonomy archive page.
* Show tag list in a more condensed way.
= 0.18.0 =
* Remove shortcodes from global tag archive excerpts.
* Only show a max. of 30 other tags on a tag term archive.
= 0.17.0 =
* Updated readme with more useful information
* Fixed a few typos in the code
* Updated inline documentation
= 0.16.0 =
* Added a filter for roles to be allowed managing global tags.
* Check and add capabilities to user roles so they can add and create global tags, fixes https://github.com/dol-lab/spaces-global-tags/issues/20
= 0.15.0 =
* Added a filter for post types with multisite taxonomies.
* Implemented a check for post type when finding tags in content, fixes https://github.com/dol-lab/spaces-global-tags/issues/18
= 0.14.0 =
* Removed a CSS class on the global tag archive template for production.
= 0.13.0 =
* Added REST API endpoints for global comment and post tags.
* Added Tribute JS by ZURB to allow auto completion for tags.
* Implemented auto completion for CKEditor and comment forms.
= 0.12.0 =
* Changed approach for archive pages for now, using parts of https://github.com/HarvardChanSchool/multisite-taxonomies-frontend
= 0.11.0 =
* Added first spaces specific fixes for urls using spaces_options.
= 0.10.0 =
* Fixed a bug to link to the proper multisite term archive page.
* First pass at filling the multisite term archive pages.
* Changed reusable strings to constants.
* Added GPL in plugin header.
= 0.9.0 =
* Fixed a bug that prevented comment and post tags to be linked properly.
* Added implementation for global post tags to work in the same fashion as comment tags.
* Added README.md
* Added translation file.
= 0.8.0 =
* Add composer.json support.
* Implement PSR4 autoloader for classes.
* Add method to filter displayed comment/content with links to the tag archive pages.
* Implement logic for parsing and settings terms for posts in comments.
= 0.7.0 =
* Implement abstract class Hashtag_Parser.
* Setting up Post_Tags and Comment_Tags classes.
= 0.6.0 =
* Remove `post_tag` from `post` object.
* Add `global_post_tag` to `post` object.
* Add `global_comment_tag` to `post` object.
= 0.5.0 =
* Started re-build on Multisite Taxonomies plugin.
= 0.4.0 =
* Moved uninstall flush_rewrite_rules to deactivation hook.
= 0.3.0 =
* Implemented an uninstall.php file with a class to truly uninstall the plugin.
= 0.2.0 =
* Added custom rewrite rules for global tag archive pages.
= 0.1.0 =
* Initial version, very limited and only as a playground.