-
Notifications
You must be signed in to change notification settings - Fork 1
/
readme.txt
106 lines (73 loc) · 3.01 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
=== Log Out Shortcode ===
Tags: logout, shortcode, log-out, log out, link
Contributors: jamescollins
Requires at least: 6.0
Tested up to: 6.6
Stable tag: 1.1.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Easily add a log out link or button to a post or page using a simple shortcode.
== Description ==
There are 3 shortcodes that can be used:
`[logout]` - A standard Log Out link, where the user stays on the login screen after being logged out.
`[logout_to_home]` - A link that logs the user out, and redirects them to your home page.
`[logout_to_current]` - A link that logs the user out, and redirects them back to the current page/URL.
**Advanced Usage:**
All 3 shortcodes all support 3 attributes/parameters:
`[logout text="" class="" redirect=""]`
The 3 supported attributes/parameters are:
`text=""`
- The text to use for the link anchor text.
- Default: `Log Out`
`class=""`
- The HTML class(es) to use for the link. Multiple classes should be separated by a space.
- Default: `logout`
`redirect=""`
- The path/URL to redirect the user to after they are logged out.
- Default: the WordPress login screen.
- Note: must be a URL or path on the same domain name as the WordPress website (cannot be an external domain/URL)
**Some Examples:**
`[logout text="Log Off"]` - A `Log Off` link that logs the user out.
`[logout redirect="/members/"]` - Log the user out, and redirect them to `/members/`.
`[logout_to_home text="Log Off"]` - A `Log Off` link that logs the user out and redirects them to your home page.
`[logout class="log-out-link"]` - Use a custom CSS/HTML class name for the log out link.
Note: the shortcodes will return nothing/empty if the user isn't logged in.
This plugin is inspired by the [Logout Button plugin by Ben Poland](https://wordpress.org/plugins/logout-button/).
If you like, you can [contribute to this plugin on GitHub](https://github.com/OM4/log-out-shortcode).
== Installation ==
1. Activate the plugin.
1. Add one of the shortcodes to a post/page.
== Frequently Asked Questions ==
= What shortcodes can be used? =
Please see the [plugin description](https://wordpress.org/plugins/log-out-shortcode/) for a list of shortcodes and supported parameters.
== Changelog ==
= 1.1.3 =
* Fix version number.
= 1.1.2 =
* Mark compatibility with WordPress version 6.6.
= 1.1.1 =
* Mark compatibility with WordPress version 6.5.
= 1.1.0 =
* Minimum required WordPress version updated to 6.0.
* Mark compatibility with WordPress version 6.4.
= 1.0.8 =
* Fix Typo
= 1.0.7 =
* Mark WP 5.5 compatible
= 1.0.6 =
* Mark WP 5.2 compatible
= 1.0.5 =
* Fix a bug that meant it was not possible to use specify multiple classes in the class="" attribute. Thanks to @hughc for the bug report.
= 1.0.4 =
* WordPress 4.4 compatibility.
* Documentation updates.
= 1.0.3 =
* Clarify usage of the redirect="" parameter.
* WordPress 4.1 compatibility.
= 1.0.2 =
* WordPress 4.0 compatibility.
= 1.0.1 =
* WordPress 3.9.2 compatibility.
* Add [logout] shortcode to plugin description.
= 1.0 =
* Initial release.