-
Notifications
You must be signed in to change notification settings - Fork 19
/
readme.txt
229 lines (160 loc) · 7.83 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
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
=== Custom Permalinks ===
Contributors: sasiddiqui
Tags: permalink, url, link, address, redirect, custom post type
Tested up to: 6.6
Stable tag: 2.7.0
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html
Set custom permalinks on a per-post, per-tag or per-category basis.
== Description ==
> In case of found any site breaking issue after upgrading to the latest version then please report the issue on [WordPress Forum](https://wordpress.org/support/plugin/custom-permalinks/) OR [GitHub](https://github.com/samiahmedsiddiqui/custom-permalinks) with complete information to reproduce the issue and move back to the old version. You can download any of the old version from here: https://wordpress.org/plugins/custom-permalinks/advanced/
Lay out your site the way *you* want it. Set the URL of any post, page, tag or category to anything you want. Old permalinks will redirect properly to the new address. Custom Permalinks give you ultimate control over your site structure.
> Be warned: *This plugin is not a replacement for WordPress's built-in permalink system*. Check your WordPress administration's "Permalinks" settings page first, to make sure that this doesn't already meet your needs.
This plugin is only useful for assigning custom permalinks for *individual* posts, pages, tags or categories. It will not apply whole permalink structures or automatically apply a category's custom permalink to the posts within that category.
== Filters ==
=== Add `PATH_INFO` in `$_SERVER` Variable ===
`
add_filter( 'custom_permalinks_path_info', '__return_true' );
`
=== Disable Redirects ===
To disable complete redirects functionality provided by this plugin, add the filter that looks like this:
`
function yasglobal_avoid_redirect( $permalink ) {
return true;
}
add_filter( 'custom_permalinks_avoid_redirect', 'yasglobal_avoid_redirect' );
`
=== Disable Particular Redirects ===
To disable any specific redirect to be processed by this plugin, add the filter that looks like this:
`
function yasglobal_avoid_redirect( $permalink ) {
// Replace 'testing-hello-world/' with the permalink you want to avoid
if ( 'testing-hello-world/' === $permalink ) {
return true;
}
return false;
}
add_filter( 'custom_permalinks_avoid_redirect', 'yasglobal_avoid_redirect' );
`
=== Exclude Permalink to be processed ===
To exclude any Permalink to be processed by the plugin, add the filter that looks like this:
`
function yasglobal_xml_sitemap_url( $permalink ) {
if ( false !== strpos( $permalink, 'sitemap.xml' ) ) {
return '__true';
}
return;
}
add_filter( 'custom_permalinks_request_ignore', 'yasglobal_xml_sitemap_url' );
`
=== Exclude Post Type ===
To remove custom permalink **form** from any post type, add the filter that looks like this:
`
function yasglobal_exclude_post_types( $post_type ) {
// Replace 'custompost' with your post type name
if ( 'custompost' === $post_type ) {
return '__true';
}
return '__false';
}
add_filter( 'custom_permalinks_exclude_post_type', 'yasglobal_exclude_post_types' );
`
=== Exclude Posts ===
To exclude custom permalink **form** from any posts (based on ID, Template, etc), add the filter that looks like this:
`
function yasglobal_exclude_posts( $post ) {
if ( 1557 === $post->ID ) {
return true;
}
return false;
}
add_filter( 'custom_permalinks_exclude_posts', 'yasglobal_exclude_posts' );
`
=== Allow Accents Letters ===
To allow accents letters, please add below-mentioned line in your theme `functions.php`:
`
function yasglobal_permalink_allow_accents() {
return true;
}
add_filter( 'custom_permalinks_allow_accents', 'yasglobal_permalink_allow_accents' );
`
=== Allow Uppercase Letters ===
To allow uppercase letters/words, please add below-mentioned line in your theme `functions.php`:
`
function yasglobal_allow_uppercaps() {
return true;
}
add_filter( 'custom_permalinks_allow_caps', 'yasglobal_allow_uppercaps' );
`
=== Allow Redundant Hyphens ===
To allow redundant hyphens, please add below-mentioned line in your theme `functions.php`:
`
function yasglobal_redundant_hyphens() {
return true;
}
add_filter( 'custom_permalinks_redundant_hyphens', 'yasglobal_redundant_hyphens' );
`
=== Manipulate Permalink Before Saving ===
To make changes in permalink before saving, please use `custom_permalink_before_saving` filter. Here is an example to see how it works.
`
function yasglobal_permalink_before_saving( $permalink, $post_id ) {
// Check trialing slash in the permalink.
if ( substr( $permalink, -1 ) !== '/' ) {
// If permalink doesn't contain trialing slash then add one.
$permalink .= '/';
}
return $permalink;
}
add_filter( 'custom_permalink_before_saving', 'yasglobal_permalink_before_saving', 10, 2 );
`
=== Remove `like` Query ===
To remove `like` query to being work, add below-mentioned line in your theme `functions.php`:
`
add_filter( 'cp_remove_like_query', '__return_false' );
`
Note: Use `custom_permalinks_like_query` filter if the URLs doesn't works for you after upgrading to `v1.2.9`.
=== Thanks for the Support ===
I do not always provide active support for the Custom Permalinks plugin on the WordPress.org forums, as I have prioritized the email support. One-on-one email support is available to people who bought [Custom Permalinks Premium](https://www.custompermalinks.com/#pricing-section) only.
=== Bug reports ===
Bug reports for Custom Permalinks are [welcomed on GitHub](https://github.com/samiahmedsiddiqui/custom-permalinks). Please note GitHub is not a support forum, and issues that aren't properly qualified as bugs will be closed.
== Installation ==
This process defines you the steps to follow either you are installing through WordPress or Manually from FTP.
**From within WordPress**
1. Visit 'Plugins > Add New'
2. Search for Custom Permalinks
3. Activate Custom Permalinks from your Plugins page.
**Manually**
1. Upload the `custom-permalinks` folder to the `/wp-content/plugins/` directory
2. Activate Custom Permalinks through the 'Plugins' menu in WordPress
== Changelog ==
= 2.7.0 - Aug 20, 2024 =
* Bug
* [Passing null to parameter string is deprecated](https://github.com/samiahmedsiddiqui/custom-permalinks/pull/86)
* [Fix PHP warning with empty permalink on new page/post](https://github.com/samiahmedsiddiqui/custom-permalinks/pull/87)
* [Authenticated(Editor+) Stored Cross-Site Scripting](https://github.com/samiahmedsiddiqui/custom-permalinks/pull/96)
* Enhancement:
* [Improve I18N](https://github.com/samiahmedsiddiqui/custom-permalinks/pull/72)
= 2.6.0 - Aug 15, 2024 =
* Feature Additions:
* Compatibility with PolyLang Plugin
= 2.5.2 - Feb 14, 2023 =
* Bug
* [Error in new update](https://wordpress.org/support/topic/error-in-new-update-3/)
= 2.5.1 - Feb 14, 2023 =
* Bug
* [“http//” is added in front of permalinks](https://github.com/samiahmedsiddiqui/custom-permalinks/issues/71)
= 2.5.0 - Jan 02, 2023 =
* Bugs
* [Retreiving info from installed plugin (GDPR)](https://wordpress.org/support/topic/retreiving-info-from-installed-plugin-gdpr/)
* Enhancement
* Same permalink with WPML different domain
= 2.4.0 - Nov 26, 2021 =
* Bugs
* [filter for leading special characters](https://wordpress.org/support/topic/filter-for-leading-special-characters/)
* [“search Permalinks” button doesn’t work. (part2)](https://wordpress.org/support/topic/search-permalinks-button-doesnt-work-part2/)
* [PHP 8 errors on first visit of Taxonomy Permalinks tab](https://github.com/samiahmedsiddiqui/custom-permalinks/issues/59)
* [Notice: Undefined variable: site_url in custom-permalinks/admin/class-custom-permalinks-post-types-table.php on line 306](https://github.com/samiahmedsiddiqui/custom-permalinks/issues/56)
* Enhancements
* [Pending Post Preview Link](https://wordpress.org/support/topic/pending-post-preview-link/)
= Earlier versions =
* For the changelog of earlier versions, please refer to the separate changelog.txt file.