├── readme.txt ├── license.txt └── fixed-adjacent-post.php /readme.txt: -------------------------------------------------------------------------------- 1 | === Fixed Adjacent Post === 2 | Contributors: ixkaito 3 | Tags: adjacent, post, links, previous post, next post 4 | Requires at least: 3.9-RC1 5 | Tested up to: 3.9 6 | Stable tag: 1.0 7 | License: GPLv2 or later 8 | License URI: http://www.gnu.org/licenses/gpl-2.0.html 9 | 10 | Fix the not-excluding terms bug of `get_adjacent_post()`. 11 | 12 | == Description == 13 | 14 | Usage: 15 | 16 | * `get_fixed_previous_post( $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' )` 17 | - instead of `get_previous_post()` 18 | 19 | * `get_fixed_next_post( $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' )` 20 | - instead of `get_next_post()` 21 | 22 | * `get_fixed_adjacent_post( $in_same_term = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' )` 23 | - instead of `get_adjacent_post()` 24 | 25 | * `get_fixed_adjacent_post_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' )` 26 | - instead of `get_adjacent_post_rel_link()` 27 | 28 | * `fixed_adjacent_posts_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' )` 29 | - instead of `adjacent_posts_rel_link()` 30 | 31 | * `fixed_adjacent_posts_rel_link_wp_head()` 32 | - instead of `adjacent_posts_rel_link_wp_head()` 33 | 34 | * `fixed_next_post_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' )` 35 | - instead of `next_post_rel_link()` 36 | 37 | * `fixed_prev_post_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' )` 38 | - instead of `prev_post_rel_link()` 39 | 40 | * `get_fixed_previous_post_link( $format = '« %link', $link = '%title', $in_same_cat = false, $excluded_terms = '', $taxonomy = 'category' )` 41 | - instead of `get_previous_post_link()` 42 | 43 | * `fixed_previous_post_link( $format = '« %link', $link = '%title', $in_same_cat = false, $excluded_terms = '', $taxonomy = 'category' )` 44 | - instead of `previous_post_link()` 45 | 46 | * `get_fixed_next_post_link( $format = '%link »', $link = '%title', $in_same_cat = false, $excluded_terms = '', $taxonomy = 'category' )` 47 | - instead of `get_next_post_link()` 48 | 49 | * `fixed_next_post_link( $format = '%link »', $link = '%title', $in_same_cat = false, $excluded_terms = '', $taxonomy = 'category' )` 50 | - instead of `next_post_link()` 51 | 52 | * `get_fixed_adjacent_post_link( $format, $link, $in_same_cat = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' )` 53 | - instead of `get_adjacent_post_link()` 54 | 55 | * `fixed_adjacent_post_link( $format, $link, $in_same_cat = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' )` 56 | - instead of `adjacent_post_link()` 57 | 58 | == Installation == 59 | 60 | 1. Upload the `fixed-adjacent-post` folder to the `/wp-content/plugins/` directory. 61 | 2. Activate the plugin through the Plugins menu in WordPress. 62 | 3. Then you can use the above functions in your themes. 63 | 64 | == Changelog == 65 | 66 | = 1.0 = 67 | * The first version. 68 | -------------------------------------------------------------------------------- /license.txt: -------------------------------------------------------------------------------- 1 | GNU GENERAL PUBLIC LICENSE 2 | Version 2, June 1991 3 | 4 | Copyright (C) 1989, 1991 Free Software Foundation, Inc. 5 | 675 Mass Ave, Cambridge, MA 02139, USA 6 | Everyone is permitted to copy and distribute verbatim copies 7 | of this license document, but changing it is not allowed. 8 | 9 | Preamble 10 | 11 | The licenses for most software are designed to take away your 12 | freedom to share and change it. By contrast, the GNU General Public 13 | License is intended to guarantee your freedom to share and change free 14 | software--to make sure the software is free for all its users. This 15 | General Public License applies to most of the Free Software 16 | Foundation's software and to any other program whose authors commit to 17 | using it. (Some other Free Software Foundation software is covered by 18 | the GNU Library General Public License instead.) You can apply it to 19 | your programs, too. 20 | 21 | When we speak of free software, we are referring to freedom, not 22 | price. Our General Public Licenses are designed to make sure that you 23 | have the freedom to distribute copies of free software (and charge for 24 | this service if you wish), that you receive source code or can get it 25 | if you want it, that you can change the software or use pieces of it 26 | in new free programs; and that you know you can do these things. 27 | 28 | To protect your rights, we need to make restrictions that forbid 29 | anyone to deny you these rights or to ask you to surrender the rights. 30 | These restrictions translate to certain responsibilities for you if you 31 | distribute copies of the software, or if you modify it. 32 | 33 | For example, if you distribute copies of such a program, whether 34 | gratis or for a fee, you must give the recipients all the rights that 35 | you have. You must make sure that they, too, receive or can get the 36 | source code. And you must show them these terms so they know their 37 | rights. 38 | 39 | We protect your rights with two steps: (1) copyright the software, and 40 | (2) offer you this license which gives you legal permission to copy, 41 | distribute and/or modify the software. 42 | 43 | Also, for each author's protection and ours, we want to make certain 44 | that everyone understands that there is no warranty for this free 45 | software. If the software is modified by someone else and passed on, we 46 | want its recipients to know that what they have is not the original, so 47 | that any problems introduced by others will not reflect on the original 48 | authors' reputations. 49 | 50 | Finally, any free program is threatened constantly by software 51 | patents. We wish to avoid the danger that redistributors of a free 52 | program will individually obtain patent licenses, in effect making the 53 | program proprietary. To prevent this, we have made it clear that any 54 | patent must be licensed for everyone's free use or not licensed at all. 55 | 56 | The precise terms and conditions for copying, distribution and 57 | modification follow. 58 | 59 | GNU GENERAL PUBLIC LICENSE 60 | TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 61 | 62 | 0. This License applies to any program or other work which contains 63 | a notice placed by the copyright holder saying it may be distributed 64 | under the terms of this General Public License. The "Program", below, 65 | refers to any such program or work, and a "work based on the Program" 66 | means either the Program or any derivative work under copyright law: 67 | that is to say, a work containing the Program or a portion of it, 68 | either verbatim or with modifications and/or translated into another 69 | language. (Hereinafter, translation is included without limitation in 70 | the term "modification".) Each licensee is addressed as "you". 71 | 72 | Activities other than copying, distribution and modification are not 73 | covered by this License; they are outside its scope. The act of 74 | running the Program is not restricted, and the output from the Program 75 | is covered only if its contents constitute a work based on the 76 | Program (independent of having been made by running the Program). 77 | Whether that is true depends on what the Program does. 78 | 79 | 1. You may copy and distribute verbatim copies of the Program's 80 | source code as you receive it, in any medium, provided that you 81 | conspicuously and appropriately publish on each copy an appropriate 82 | copyright notice and disclaimer of warranty; keep intact all the 83 | notices that refer to this License and to the absence of any warranty; 84 | and give any other recipients of the Program a copy of this License 85 | along with the Program. 86 | 87 | You may charge a fee for the physical act of transferring a copy, and 88 | you may at your option offer warranty protection in exchange for a fee. 89 | 90 | 2. You may modify your copy or copies of the Program or any portion 91 | of it, thus forming a work based on the Program, and copy and 92 | distribute such modifications or work under the terms of Section 1 93 | above, provided that you also meet all of these conditions: 94 | 95 | a) You must cause the modified files to carry prominent notices 96 | stating that you changed the files and the date of any change. 97 | 98 | b) You must cause any work that you distribute or publish, that in 99 | whole or in part contains or is derived from the Program or any 100 | part thereof, to be licensed as a whole at no charge to all third 101 | parties under the terms of this License. 102 | 103 | c) If the modified program normally reads commands interactively 104 | when run, you must cause it, when started running for such 105 | interactive use in the most ordinary way, to print or display an 106 | announcement including an appropriate copyright notice and a 107 | notice that there is no warranty (or else, saying that you provide 108 | a warranty) and that users may redistribute the program under 109 | these conditions, and telling the user how to view a copy of this 110 | License. (Exception: if the Program itself is interactive but 111 | does not normally print such an announcement, your work based on 112 | the Program is not required to print an announcement.) 113 | 114 | These requirements apply to the modified work as a whole. If 115 | identifiable sections of that work are not derived from the Program, 116 | and can be reasonably considered independent and separate works in 117 | themselves, then this License, and its terms, do not apply to those 118 | sections when you distribute them as separate works. But when you 119 | distribute the same sections as part of a whole which is a work based 120 | on the Program, the distribution of the whole must be on the terms of 121 | this License, whose permissions for other licensees extend to the 122 | entire whole, and thus to each and every part regardless of who wrote it. 123 | Thus, it is not the intent of this section to claim rights or contest 124 | your rights to work written entirely by you; rather, the intent is to 125 | exercise the right to control the distribution of derivative or 126 | collective works based on the Program. 127 | 128 | In addition, mere aggregation of another work not based on the Program 129 | with the Program (or with a work based on the Program) on a volume of 130 | a storage or distribution medium does not bring the other work under 131 | the scope of this License. 132 | 133 | 3. You may copy and distribute the Program (or a work based on it, 134 | under Section 2) in object code or executable form under the terms of 135 | Sections 1 and 2 above provided that you also do one of the following: 136 | 137 | a) Accompany it with the complete corresponding machine-readable 138 | source code, which must be distributed under the terms of Sections 139 | 1 and 2 above on a medium customarily used for software interchange; or, 140 | 141 | b) Accompany it with a written offer, valid for at least three 142 | years, to give any third party, for a charge no more than your 143 | cost of physically performing source distribution, a complete 144 | machine-readable copy of the corresponding source code, to be 145 | distributed under the terms of Sections 1 and 2 above on a medium 146 | customarily used for software interchange; or, 147 | 148 | c) Accompany it with the information you received as to the offer 149 | to distribute corresponding source code. (This alternative is 150 | allowed only for noncommercial distribution and only if you 151 | received the program in object code or executable form with such 152 | an offer, in accord with Subsection b above.) 153 | 154 | The source code for a work means the preferred form of the work for 155 | making modifications to it. For an executable work, complete source 156 | code means all the source code for all modules it contains, plus any 157 | associated interface definition files, plus the scripts used to 158 | control compilation and installation of the executable. However, as a 159 | special exception, the source code distributed need not include 160 | anything that is normally distributed (in either source or binary 161 | form) with the major components (compiler, kernel, and so on) of the 162 | operating system on which the executable runs, unless that component 163 | itself accompanies the executable. 164 | 165 | If distribution of executable or object code is made by offering 166 | access to copy from a designated place, then offering equivalent 167 | access to copy the source code from the same place counts as 168 | distribution of the source code, even though third parties are not 169 | compelled to copy the source along with the object code. 170 | 171 | 4. You may not copy, modify, sublicense, or distribute the Program 172 | except as expressly provided under this License. Any attempt 173 | otherwise to copy, modify, sublicense or distribute the Program is 174 | void, and will automatically terminate your rights under this License. 175 | However, parties who have received copies, or rights, from you under 176 | this License will not have their licenses terminated so long as such 177 | parties remain in full compliance. 178 | 179 | 5. You are not required to accept this License, since you have not 180 | signed it. However, nothing else grants you permission to modify or 181 | distribute the Program or its derivative works. These actions are 182 | prohibited by law if you do not accept this License. Therefore, by 183 | modifying or distributing the Program (or any work based on the 184 | Program), you indicate your acceptance of this License to do so, and 185 | all its terms and conditions for copying, distributing or modifying 186 | the Program or works based on it. 187 | 188 | 6. Each time you redistribute the Program (or any work based on the 189 | Program), the recipient automatically receives a license from the 190 | original licensor to copy, distribute or modify the Program subject to 191 | these terms and conditions. You may not impose any further 192 | restrictions on the recipients' exercise of the rights granted herein. 193 | You are not responsible for enforcing compliance by third parties to 194 | this License. 195 | 196 | 7. If, as a consequence of a court judgment or allegation of patent 197 | infringement or for any other reason (not limited to patent issues), 198 | conditions are imposed on you (whether by court order, agreement or 199 | otherwise) that contradict the conditions of this License, they do not 200 | excuse you from the conditions of this License. If you cannot 201 | distribute so as to satisfy simultaneously your obligations under this 202 | License and any other pertinent obligations, then as a consequence you 203 | may not distribute the Program at all. For example, if a patent 204 | license would not permit royalty-free redistribution of the Program by 205 | all those who receive copies directly or indirectly through you, then 206 | the only way you could satisfy both it and this License would be to 207 | refrain entirely from distribution of the Program. 208 | 209 | If any portion of this section is held invalid or unenforceable under 210 | any particular circumstance, the balance of the section is intended to 211 | apply and the section as a whole is intended to apply in other 212 | circumstances. 213 | 214 | It is not the purpose of this section to induce you to infringe any 215 | patents or other property right claims or to contest validity of any 216 | such claims; this section has the sole purpose of protecting the 217 | integrity of the free software distribution system, which is 218 | implemented by public license practices. Many people have made 219 | generous contributions to the wide range of software distributed 220 | through that system in reliance on consistent application of that 221 | system; it is up to the author/donor to decide if he or she is willing 222 | to distribute software through any other system and a licensee cannot 223 | impose that choice. 224 | 225 | This section is intended to make thoroughly clear what is believed to 226 | be a consequence of the rest of this License. 227 | 228 | 8. If the distribution and/or use of the Program is restricted in 229 | certain countries either by patents or by copyrighted interfaces, the 230 | original copyright holder who places the Program under this License 231 | may add an explicit geographical distribution limitation excluding 232 | those countries, so that distribution is permitted only in or among 233 | countries not thus excluded. In such case, this License incorporates 234 | the limitation as if written in the body of this License. 235 | 236 | 9. The Free Software Foundation may publish revised and/or new versions 237 | of the General Public License from time to time. Such new versions will 238 | be similar in spirit to the present version, but may differ in detail to 239 | address new problems or concerns. 240 | 241 | Each version is given a distinguishing version number. If the Program 242 | specifies a version number of this License which applies to it and "any 243 | later version", you have the option of following the terms and conditions 244 | either of that version or of any later version published by the Free 245 | Software Foundation. If the Program does not specify a version number of 246 | this License, you may choose any version ever published by the Free Software 247 | Foundation. 248 | 249 | 10. If you wish to incorporate parts of the Program into other free 250 | programs whose distribution conditions are different, write to the author 251 | to ask for permission. For software which is copyrighted by the Free 252 | Software Foundation, write to the Free Software Foundation; we sometimes 253 | make exceptions for this. Our decision will be guided by the two goals 254 | of preserving the free status of all derivatives of our free software and 255 | of promoting the sharing and reuse of software generally. 256 | 257 | NO WARRANTY 258 | 259 | 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY 260 | FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN 261 | OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES 262 | PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED 263 | OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 264 | MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS 265 | TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE 266 | PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, 267 | REPAIR OR CORRECTION. 268 | 269 | 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING 270 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR 271 | REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, 272 | INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING 273 | OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED 274 | TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY 275 | YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER 276 | PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE 277 | POSSIBILITY OF SUCH DAMAGES. 278 | 279 | END OF TERMS AND CONDITIONS 280 | 281 | -------------------------------------------------------------------------------- /fixed-adjacent-post.php: -------------------------------------------------------------------------------- 1 | post_date; 59 | 60 | $join = ''; 61 | $posts_in_ex_terms_sql = ''; 62 | if ( $in_same_term || ! empty( $excluded_terms ) ) { 63 | $join = " INNER JOIN $wpdb->term_relationships AS tr ON p.ID = tr.object_id INNER JOIN $wpdb->term_taxonomy tt ON tr.term_taxonomy_id = tt.term_taxonomy_id"; 64 | 65 | if ( $in_same_term ) { 66 | if ( ! is_object_in_taxonomy( $post->post_type, $taxonomy ) ) 67 | return ''; 68 | $term_array = wp_get_object_terms( $post->ID, $taxonomy, array( 'fields' => 'ids' ) ); 69 | if ( ! $term_array || is_wp_error( $term_array ) ) 70 | return ''; 71 | $join .= $wpdb->prepare( " AND tt.taxonomy = %s AND tt.term_id IN (" . implode( ',', array_map( 'intval', $term_array ) ) . ")", $taxonomy ); 72 | } 73 | 74 | $posts_in_ex_terms_sql = $wpdb->prepare( "AND tt.taxonomy = %s", $taxonomy ); 75 | if ( ! empty( $excluded_terms ) ) { 76 | if ( ! is_array( $excluded_terms ) ) { 77 | // back-compat, $excluded_terms used to be $excluded_terms with IDs separated by " and " 78 | if ( false !== strpos( $excluded_terms, ' and ' ) ) { 79 | _deprecated_argument( __FUNCTION__, '3.3', sprintf( __( 'Use commas instead of %s to separate excluded terms.' ), "'and'" ) ); 80 | $excluded_terms = explode( ' and ', $excluded_terms ); 81 | } else { 82 | $excluded_terms = explode( ',', $excluded_terms ); 83 | } 84 | } 85 | 86 | $excluded_terms = array_map( 'intval', $excluded_terms ); 87 | 88 | if ( ! empty( $term_array ) ) { 89 | // $excluded_terms = array_diff( $excluded_terms, $term_array ); 90 | $posts_in_ex_terms_sql = ''; 91 | } 92 | 93 | if ( ! empty( $excluded_terms ) ) { 94 | $posts_in_ex_terms_sql = $wpdb->prepare( " AND tt.taxonomy = %s AND tt.term_id NOT IN (" . implode( $excluded_terms, ',' ) . ')', $taxonomy ); 95 | } 96 | } 97 | } 98 | 99 | $adjacent = $previous ? 'previous' : 'next'; 100 | $op = $previous ? '<' : '>'; 101 | $order = $previous ? 'DESC' : 'ASC'; 102 | 103 | /** 104 | * Filter the JOIN clause in the SQL for an adjacent post query. 105 | * 106 | * The dynamic portion of the hook name, $adjacent, refers to the type 107 | * of adjacency, 'next' or 'previous'. 108 | * 109 | * @since 2.5.0 110 | * 111 | * @param string $join The JOIN clause in the SQL. 112 | * @param bool $in_same_term Whether post should be in a same taxonomy term. 113 | * @param array $excluded_terms Array of excluded term IDs. 114 | */ 115 | $join = apply_filters( "get_{$adjacent}_post_join", $join, $in_same_term, $excluded_terms ); 116 | 117 | /** 118 | * Filter the WHERE clause in the SQL for an adjacent post query. 119 | * 120 | * The dynamic portion of the hook name, $adjacent, refers to the type 121 | * of adjacency, 'next' or 'previous'. 122 | * 123 | * @since 2.5.0 124 | * 125 | * @param string $where The WHERE clause in the SQL. 126 | * @param bool $in_same_term Whether post should be in a same taxonomy term. 127 | * @param array $excluded_terms Array of excluded term IDs. 128 | */ 129 | $where = apply_filters( "get_{$adjacent}_post_where", $wpdb->prepare( "WHERE p.post_date $op %s AND p.post_type = %s AND p.post_status = 'publish' $posts_in_ex_terms_sql", $current_post_date, $post->post_type), $in_same_term, $excluded_terms ); 130 | 131 | /** 132 | * Filter the ORDER BY clause in the SQL for an adjacent post query. 133 | * 134 | * The dynamic portion of the hook name, $adjacent, refers to the type 135 | * of adjacency, 'next' or 'previous'. 136 | * 137 | * @since 2.5.0 138 | * 139 | * @param string $order_by The ORDER BY clause in the SQL. 140 | */ 141 | $sort = apply_filters( "get_{$adjacent}_post_sort", "ORDER BY p.post_date $order LIMIT 1" ); 142 | 143 | $query = "SELECT p.ID FROM $wpdb->posts AS p $join $where $posts_in_ex_terms_sql $sort"; 144 | $query_key = 'adjacent_post_' . md5( $query ); 145 | $result = wp_cache_get( $query_key, 'counts' ); 146 | if ( false !== $result ) { 147 | if ( $result ) 148 | $result = get_post( $result ); 149 | return $result; 150 | } 151 | 152 | $result = $wpdb->get_var( $query ); 153 | if ( null === $result ) 154 | $result = ''; 155 | 156 | wp_cache_set( $query_key, $result, 'counts' ); 157 | 158 | if ( $result ) 159 | $result = get_post( $result ); 160 | 161 | return $result; 162 | } 163 | 164 | /** 165 | * Get adjacent post relational link. 166 | * 167 | * Can either be next or previous post relational link. 168 | * 169 | * @since 2.8.0 170 | * 171 | * @param string $title Optional. Link title format. 172 | * @param bool $in_same_term Optional. Whether link should be in a same taxonomy term. 173 | * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. 174 | * @param bool $previous Optional. Whether to display link to previous or next post. Default true. 175 | * @param string $taxonomy Optional. Taxonomy, if $in_same_term is true. Default 'category'. 176 | * @return string 177 | */ 178 | function get_fixed_adjacent_post_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' ) { 179 | if ( $previous && is_attachment() && $post = get_post() ) 180 | $post = get_post( $post->post_parent ); 181 | else 182 | $post = get_fixed_adjacent_post( $in_same_term, $excluded_terms, $previous, $taxonomy ); 183 | 184 | if ( empty( $post ) ) 185 | return; 186 | 187 | $post_title = the_title_attribute( array( 'echo' => false, 'post' => $post ) ); 188 | 189 | if ( empty( $post_title ) ) 190 | $post_title = $previous ? __( 'Previous Post' ) : __( 'Next Post' ); 191 | 192 | $date = mysql2date( get_option( 'date_format' ), $post->post_date ); 193 | 194 | $title = str_replace( '%title', $post_title, $title ); 195 | $title = str_replace( '%date', $date, $title ); 196 | 197 | $link = $previous ? "\n"; 200 | 201 | $adjacent = $previous ? 'previous' : 'next'; 202 | 203 | /** 204 | * Filter the adjacent post relational link. 205 | * 206 | * The dynamic portion of the hook name, $adjacent, refers to the type 207 | * of adjacency, 'next' or 'previous'. 208 | * 209 | * @since 2.8.0 210 | * 211 | * @param string $link The relational link. 212 | */ 213 | return apply_filters( "{$adjacent}_post_rel_link", $link ); 214 | } 215 | 216 | /** 217 | * Display relational links for the posts adjacent to the current post. 218 | * 219 | * @since 2.8.0 220 | * 221 | * @param string $title Optional. Link title format. 222 | * @param bool $in_same_term Optional. Whether link should be in a same taxonomy term. 223 | * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. 224 | * @param string $taxonomy Optional. Taxonomy, if $in_same_term is true. Default 'category'. 225 | */ 226 | function fixed_adjacent_posts_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) { 227 | echo get_fixed_adjacent_post_rel_link( $title, $in_same_term, $excluded_terms, true, $taxonomy ); 228 | echo get_fixed_adjacent_post_rel_link( $title, $in_same_term, $excluded_terms, false, $taxonomy ); 229 | } 230 | 231 | /** 232 | * Display relational links for the posts adjacent to the current post for single post pages. 233 | * 234 | * This is meant to be attached to actions like 'wp_head'. Do not call this directly in plugins or theme templates. 235 | * @since 3.0.0 236 | * 237 | */ 238 | function fixed_adjacent_posts_rel_link_wp_head() { 239 | if ( !is_singular() || is_attachment() ) 240 | return; 241 | fixed_adjacent_posts_rel_link(); 242 | } 243 | 244 | /** 245 | * Display relational link for the next post adjacent to the current post. 246 | * 247 | * @since 2.8.0 248 | * 249 | * @param string $title Optional. Link title format. 250 | * @param bool $in_same_term Optional. Whether link should be in a same taxonomy term. 251 | * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. 252 | * @param string $taxonomy Optional. Taxonomy, if $in_same_term is true. Default 'category'. 253 | */ 254 | function fixed_next_post_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) { 255 | echo get_fixed_adjacent_post_rel_link( $title, $in_same_term, $excluded_terms, false, $taxonomy ); 256 | } 257 | 258 | /** 259 | * Display relational link for the previous post adjacent to the current post. 260 | * 261 | * @since 2.8.0 262 | * 263 | * @param string $title Optional. Link title format. 264 | * @param bool $in_same_term Optional. Whether link should be in a same taxonomy term. 265 | * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default true. 266 | * @param string $taxonomy Optional. Taxonomy, if $in_same_term is true. Default 'category'. 267 | */ 268 | function fixed_prev_post_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) { 269 | echo get_fixed_adjacent_post_rel_link( $title, $in_same_term, $excluded_terms, true, $taxonomy ); 270 | } 271 | 272 | /* 273 | * Get previous post link that is adjacent to the current post. 274 | * 275 | * @since 3.7.0 276 | * 277 | * @param string $format Optional. Link anchor format. 278 | * @param string $link Optional. Link permalink format. 279 | * @param bool $in_same_term Optional. Whether link should be in a same taxonomy term. 280 | * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. 281 | * @param string $taxonomy Optional. Taxonomy, if $in_same_term is true. Default 'category'. 282 | * @return string 283 | */ 284 | function get_fixed_previous_post_link( $format = '« %link', $link = '%title', $in_same_cat = false, $excluded_terms = '', $taxonomy = 'category' ) { 285 | return get_fixed_adjacent_post_link( $format, $link, $in_same_cat, $excluded_terms, true, $taxonomy ); 286 | } 287 | 288 | /** 289 | * Display previous post link that is adjacent to the current post. 290 | * 291 | * @since 1.5.0 292 | * @see get_previous_post_link() 293 | * 294 | * @param string $format Optional. Link anchor format. 295 | * @param string $link Optional. Link permalink format. 296 | * @param bool $in_same_term Optional. Whether link should be in a same taxonomy term. 297 | * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. 298 | * @param string $taxonomy Optional. Taxonomy, if $in_same_term is true. Default 'category'. 299 | */ 300 | function fixed_previous_post_link( $format = '« %link', $link = '%title', $in_same_cat = false, $excluded_terms = '', $taxonomy = 'category' ) { 301 | echo get_fixed_previous_post_link( $format, $link, $in_same_cat, $excluded_terms, $taxonomy ); 302 | } 303 | 304 | /** 305 | * Get next post link that is adjacent to the current post. 306 | * 307 | * @since 3.7.0 308 | * 309 | * @param string $format Optional. Link anchor format. 310 | * @param string $link Optional. Link permalink format. 311 | * @param bool $in_same_term Optional. Whether link should be in a same taxonomy term. 312 | * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. 313 | * @param string $taxonomy Optional. Taxonomy, if $in_same_term is true. Default 'category'. 314 | * @return string 315 | */ 316 | function get_fixed_next_post_link( $format = '%link »', $link = '%title', $in_same_cat = false, $excluded_terms = '', $taxonomy = 'category' ) { 317 | return get_fixed_adjacent_post_link( $format, $link, $in_same_cat, $excluded_terms, false, $taxonomy ); 318 | } 319 | 320 | /** 321 | * Display next post link that is adjacent to the current post. 322 | * 323 | * @since 1.5.0 324 | * @see get_next_post_link() 325 | * 326 | * @param string $format Optional. Link anchor format. 327 | * @param string $link Optional. Link permalink format. 328 | * @param bool $in_same_term Optional. Whether link should be in a same taxonomy term. 329 | * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. 330 | * @param string $taxonomy Optional. Taxonomy, if $in_same_term is true. Default 'category'. 331 | */ 332 | function fixed_next_post_link( $format = '%link »', $link = '%title', $in_same_cat = false, $excluded_terms = '', $taxonomy = 'category' ) { 333 | echo get_fixed_next_post_link( $format, $link, $in_same_cat, $excluded_terms, $taxonomy ); 334 | } 335 | 336 | /** 337 | * Get adjacent post link. 338 | * 339 | * Can be either next post link or previous. 340 | * 341 | * @since 3.7.0 342 | * 343 | * @param string $format Link anchor format. 344 | * @param string $link Link permalink format. 345 | * @param bool $in_same_term Optional. Whether link should be in a same taxonomy term. 346 | * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded terms IDs. 347 | * @param bool $previous Optional. Whether to display link to previous or next post. Default true. 348 | * @param string $taxonomy Optional. Taxonomy, if $in_same_term is true. Default 'category'. 349 | * @return string 350 | */ 351 | function get_fixed_adjacent_post_link( $format, $link, $in_same_cat = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' ) { 352 | if ( $previous && is_attachment() ) 353 | $post = get_post( get_post()->post_parent ); 354 | else 355 | $post = get_fixed_adjacent_post( $in_same_cat, $excluded_terms, $previous, $taxonomy ); 356 | 357 | if ( ! $post ) { 358 | $output = ''; 359 | } else { 360 | $title = $post->post_title; 361 | 362 | if ( empty( $post->post_title ) ) 363 | $title = $previous ? __( 'Previous Post' ) : __( 'Next Post' ); 364 | 365 | /** This filter is documented in wp-includes/post-template.php */ 366 | $title = apply_filters( 'the_title', $title, $post->ID ); 367 | 368 | $date = mysql2date( get_option( 'date_format' ), $post->post_date ); 369 | $rel = $previous ? 'prev' : 'next'; 370 | 371 | $string = ''; 372 | $inlink = str_replace( '%title', $title, $link ); 373 | $inlink = str_replace( '%date', $date, $inlink ); 374 | $inlink = $string . $inlink . ''; 375 | 376 | $output = str_replace( '%link', $inlink, $format ); 377 | } 378 | 379 | $adjacent = $previous ? 'previous' : 'next'; 380 | 381 | /** 382 | * Filter the adjacent post link. 383 | * 384 | * The dynamic portion of the hook name, $adjacent, refers to the type 385 | * of adjacency, 'next' or 'previous'. 386 | * 387 | * @since 2.6.0 388 | * 389 | * @param string $output The adjacent post link. 390 | * @param string $format Link anchor format. 391 | * @param string $link Link permalink format. 392 | * @param WP_Post $post The adjacent post. 393 | */ 394 | return apply_filters( "{$adjacent}_post_link", $output, $format, $link, $post ); 395 | } 396 | 397 | /** 398 | * Display adjacent post link. 399 | * 400 | * Can be either next post link or previous. 401 | * 402 | * @since 2.5.0 403 | * @uses get_fixed_adjacent_post_link() 404 | * 405 | * @param string $format Link anchor format. 406 | * @param string $link Link permalink format. 407 | * @param bool $in_same_cat Optional. Whether link should be in a same category. 408 | * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded category IDs. 409 | * @param bool $previous Optional. Whether to display link to previous or next post. Default true. 410 | * @param string $taxonomy Optional. Taxonomy, if $in_same_term is true. Default 'category'. 411 | * @return string 412 | */ 413 | function fixed_adjacent_post_link( $format, $link, $in_same_cat = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' ) { 414 | echo get_fixed_adjacent_post_link( $format, $link, $in_same_cat, $excluded_terms, $previous, $taxonomy ); 415 | } 416 | --------------------------------------------------------------------------------