Automattic /
jetpack
These results are based on our legacy PHP analysis, consider migrating to our new PHP analysis engine instead. Learn more
| 1 | <?php |
||
| 152 | if ( $options['show_headline'] ) { |
||
| 153 | $headline = sprintf( |
||
| 154 | /** This filter is already documented in modules/sharedaddy/sharing-service.php */ |
||
| 155 | apply_filters( 'jetpack_sharing_headline_html', '<h3 class="jp-relatedposts-headline"><em>%s</em></h3>', esc_html( $options['headline'] ), 'related-posts' ), |
||
|
|
|||
| 156 | esc_html( $options['headline'] ) |
||
| 157 | ); |
||
| 158 | } else { |
||
| 807 | 'date_range' => array(), |
||
| 808 | 'exclude_post_ids' => array(), |
||
| 809 | ); |
||
| 810 | $args = wp_parse_args( $args, $defaults ); |
||
| 811 | /** |
||
| 812 | * Filter the arguments used to retrieve a list of Related Posts. |
||
| 813 | * |
||
| 818 | * @param array $args Array of options to retrieve Related Posts. |
||
| 819 | * @param string $post_id Post ID of the post for which we are retrieving Related Posts. |
||
| 820 | */ |
||
| 821 | $args = apply_filters( 'jetpack_relatedposts_filter_args', $args, $post_id ); |
||
| 822 | |||
| 823 | $filters = $this->_get_es_filters_from_args( $post_id, $args ); |
||
| 824 | /** |
||
| 831 | * @param array $filters Array of Elasticsearch filters based on the post_id and args. |
||
| 832 | * @param string $post_id Post ID of the post for which we are retrieving Related Posts. |
||
| 833 | */ |
||
| 834 | $filters = apply_filters( 'jetpack_relatedposts_filter_filters', $filters, $post_id ); |
||
| 835 | |||
| 836 | $results = $this->_get_related_posts( $post_id, $args['size'], $filters ); |
||
| 837 | /** |
||
| 844 | * @param array $results Array of related posts matched by Elasticsearch. |
||
| 845 | * @param string $post_id Post ID of the post for which we are retrieving Related Posts. |
||
| 846 | */ |
||
| 847 | return apply_filters( 'jetpack_relatedposts_returned_results', $results, $post_id ); |
||
| 848 | } |
||
| 849 | |||
| 850 | /** |
||
| 874 | * @param array $args['has_terms'] Array of terms associated to the Related Posts. |
||
| 875 | * @param string $post_id Post ID of the post for which we are retrieving Related Posts. |
||
| 876 | */ |
||
| 877 | $args['has_terms'] = apply_filters( 'jetpack_relatedposts_filter_has_terms', $args['has_terms'], $post_id ); |
||
| 878 | if ( ! empty( $args['has_terms'] ) ) { |
||
| 879 | foreach( (array)$args['has_terms'] as $term ) { |
||
| 880 | if ( mb_strlen( $term->taxonomy ) ) { |
||
| 904 | * @param array $args['post_type'] Array of Post Types. |
||
| 905 | * @param string $post_id Post ID of the post for which we are retrieving Related Posts. |
||
| 906 | */ |
||
| 907 | $args['post_type'] = apply_filters( 'jetpack_relatedposts_filter_post_type', $args['post_type'], $post_id ); |
||
| 908 | $valid_post_types = get_post_types(); |
||
| 909 | if ( is_array( $args['post_type'] ) ) { |
||
| 910 | $sanitized_post_types = array(); |
||
| 928 | * @param array $args['post_formats'] Array of Post Formats. |
||
| 929 | * @param string $post_id Post ID of the post for which we are retrieving Related Posts. |
||
| 930 | */ |
||
| 931 | $args['post_formats'] = apply_filters( 'jetpack_relatedposts_filter_post_formats', $args['post_formats'], $post_id ); |
||
| 932 | $valid_post_formats = get_post_format_strings(); |
||
| 933 | $sanitized_post_formats = array(); |
||
| 934 | foreach ( $args['post_formats'] as $pf ) { |
||
| 950 | * @param array $args['date_range'] Array of a month interval where we search Related Posts. |
||
| 951 | * @param string $post_id Post ID of the post for which we are retrieving Related Posts. |
||
| 952 | */ |
||
| 953 | $args['date_range'] = apply_filters( 'jetpack_relatedposts_filter_date_range', $args['date_range'], $post_id ); |
||
| 954 | if ( is_array( $args['date_range'] ) && ! empty( $args['date_range'] ) ) { |
||
| 955 | $args['date_range'] = array_map( 'intval', $args['date_range'] ); |
||
| 956 | if ( !empty( $args['date_range']['from'] ) && !empty( $args['date_range']['to'] ) ) { |
||
| 972 | * @param array $args['exclude_post_ids'] Array of Post IDs. |
||
| 973 | * @param string $post_id Post ID of the post for which we are retrieving Related Posts. |
||
| 974 | */ |
||
| 975 | $args['exclude_post_ids'] = apply_filters( 'jetpack_relatedposts_filter_exclude_post_ids', $args['exclude_post_ids'], $post_id ); |
||
| 976 | if ( !empty( $args['exclude_post_ids'] ) && is_array( $args['exclude_post_ids'] ) ) { |
||
| 977 | $excluded_post_ids = array(); |
||
| 978 | foreach ( $args['exclude_post_ids'] as $exclude_post_id) { |
||
| 1202 | * @param string $link_rel Link rel attribute for Related Posts' link. Default is empty. |
||
| 1203 | * @param int $post->ID Post ID. |
||
| 1204 | */ |
||
| 1205 | 'rel' => apply_filters( 'jetpack_relatedposts_filter_post_link_rel', '', $post->ID ), |
||
| 1206 | /** |
||
| 1207 | * Filter the context displayed below each Related Post. |
||
| 1208 | * |
||
| 1216 | 'context' => apply_filters( |
||
| 1217 | 'jetpack_relatedposts_filter_post_context', |
||
| 1218 | $this->_to_utf8( $this->_generate_related_post_context( $post->ID ) ), |
||
| 1219 | $post->ID |
||
| 1220 | ), |
||
| 1221 | 'img' => $this->_generate_related_post_image_params( $post->ID ), |
||
| 1222 | /** |
||
| 1232 | 'classes' => apply_filters( |
||
| 1233 | 'jetpack_relatedposts_filter_post_css_classes', |
||
| 1234 | array(), |
||
| 1235 | $post->ID |
||
| 1236 | ), |
||
| 1237 | ); |
||
| 1238 | } |
||
| 1397 | * @param array $hits Array of Post IDs matched by Elasticsearch. |
||
| 1398 | * @param string $post_id Post ID of the post for which we are retrieving Related Posts. |
||
| 1399 | */ |
||
| 1400 | $hits = apply_filters( 'jetpack_relatedposts_filter_hits', $hits, $post_id ); |
||
| 1401 | |||
| 1402 | $related_posts = array(); |
||
| 1403 | foreach ( $hits as $i => $hit ) { |
||
| 1559 | * @param string $post_cat_context "In Category" line displayed in the post context below each Related Post. |
||
| 1560 | * @param array $category Array containing information about the category. |
||
| 1561 | */ |
||
| 1562 | return apply_filters( 'jetpack_relatedposts_post_category_context', $post_cat_context, $category ); |
||
| 1563 | } |
||
| 1564 | } |
||
| 1565 | } |
||
| 1582 | * @param string $post_tag_context "In Tag" line displayed in the post context below each Related Post. |
||
| 1583 | * @param array $tag Array containing information about the tag. |
||
| 1584 | */ |
||
| 1585 | return apply_filters( 'jetpack_relatedposts_post_tag_context', $post_tag_context, $tag ); |
||
| 1586 | } |
||
| 1587 | } |
||
| 1588 | } |
||
| 1815 | ); |
||
| 1816 | |||
| 1817 | /** This filter is already documented in modules/related-posts/related-posts.php */ |
||
| 1818 | $hits = apply_filters( 'jetpack_relatedposts_filter_hits', $hits, $post_id ); |
||
| 1819 | |||
| 1820 | return $hits; |
||
| 1821 | } |
||
| 1822 | } |
||
| 1823 |
Xiao Yu
Jeremy Herve
Brandon Kraft
Jeremy Herve
Eduardo Reveles
Loading history...
This check compares calls to functions or methods with their respective definitions. If the call has more arguments than are defined, it raises an issue.
If a function is defined several times with a different number of parameters, the check may pick up the wrong definition and report false positives. One codebase where this has been known to happen is Wordpress.
In this case you can add the
@ignorePhpDoc annotation to the duplicate definition and it will be ignored.