Make WordPress Core

Ticket #44018: 44018.1.diff

File 44018.1.diff, 2.5 KB (added by audrasjb, 3 years ago)

Adds $args parameter for better flexibility

  • src/wp-includes/general-template.php

    diff --git a/src/wp-includes/general-template.php b/src/wp-includes/general-template.php
    index a84ffce694..70c92d6571 100644
    a b function paginate_links( $args = '' ) { 
    43574357                        break;
    43584358        }
    43594359
     4360        /**
     4361         * Filters the HTML output of `paginate_links`.
     4362         *
     4363         * @since 5.7.0
     4364         *
     4365         * @param string $r HTML output.
     4366         * @param string|array $args {
     4367         *     Optional. Array or string of arguments for generating paginated links for archives.
     4368         *
     4369         *     @type string $base               Base of the paginated url. Default empty.
     4370         *     @type string $format             Format for the pagination structure. Default empty.
     4371         *     @type int    $total              The total amount of pages. Default is the value WP_Query's
     4372         *                                      `max_num_pages` or 1.
     4373         *     @type int    $current            The current page number. Default is 'paged' query var or 1.
     4374         *     @type string $aria_current       The value for the aria-current attribute. Possible values are 'page',
     4375         *                                      'step', 'location', 'date', 'time', 'true', 'false'. Default is 'page'.
     4376         *     @type bool   $show_all           Whether to show all pages. Default false.
     4377         *     @type int    $end_size           How many numbers on either the start and the end list edges.
     4378         *                                      Default 1.
     4379         *     @type int    $mid_size           How many numbers to either side of the current pages. Default 2.
     4380         *     @type bool   $prev_next          Whether to include the previous and next links in the list. Default true.
     4381         *     @type bool   $prev_text          The previous page text. Default '« Previous'.
     4382         *     @type bool   $next_text          The next page text. Default 'Next »'.
     4383         *     @type string $type               Controls format of the returned value. Possible values are 'plain',
     4384         *                                      'array' and 'list'. Default is 'plain'.
     4385         *     @type array  $add_args           An array of query args to add. Default false.
     4386         *     @type string $add_fragment       A string to append to each link. Default empty.
     4387         *     @type string $before_page_number A string to appear before the page number. Default empty.
     4388         *     @type string $after_page_number  A string to append after the page number. Default empty.
     4389         * }
     4390         */
     4391        $r = apply_filters( 'paginate_links_output', $r, $args );
     4392
    43604393        return $r;
    43614394}
    43624395