~canonical-sysadmins/wordpress/5.1

function the_title( $before = '', $after = '', $echo = true ) {

        $title = get_the_title();

 

                return;

 

        $title = $before . $title . $after;

 

                echo $title;

                return $title;

}

 

/**

 * @return string|void String when echo is false.

 */

function the_title_attribute( $args = '' ) {

 

        $title = get_the_title( $r['post'] );

 

        $post = get_post( $post );

 

        $title = isset( $post->post_title ) ? $post->post_title : '';

 

        if ( ! is_admin() ) {

                if ( ! empty( $post->post_password ) ) {

                         * @param WP_Post $post    Current post object.

                         */

                        $protected_title_format = apply_filters( 'protected_title_format', __( 'Protected: %s' ), $post );

                } elseif ( isset( $post->post_status ) && 'private' == $post->post_status ) {

 

                        /**

                         * @param WP_Post $post    Current post object.

                         */

                        $private_title_format = apply_filters( 'private_title_format', __( 'Private: %s' ), $post );

                }

        }

 

 * @param string $more_link_text Optional. Content for when there is more text.

 * @param bool   $strip_teaser   Optional. Strip teaser content before the more text. Default is false.

 */

        $content = get_the_content( $more_link_text, $strip_teaser );

 

        /**

 * @global int   $page      Page number of a single post/page.

 * @global int   $more      Boolean indicator for whether single post/page is being viewed.

 * @global bool  $preview   Whether post/page is in preview mode.

 * @global int   $multipage Boolean indicator for whether multiple pages are in play.

 *

 * @param string $more_link_text Optional. Content for when there is more text.

                );

        }

 

        $has_teaser = false;

 

        // If post password required and it doesn't match the cookie.

                return get_the_password_form( $post );

 

                $page = count( $pages ); // give them the highest numbered page that DOES exist

 

        if ( preg_match( '/<!--more(.*?)?-->/', $content, $matches ) ) {

                $content = explode( $matches[0], $content, 2 );

                        $more_link_text = strip_tags( wp_kses_no_null( trim( $matches[1] ) ) );

 

                $has_teaser = true;

        } else {

                $content = array( $content );

        }

 

                $strip_teaser = true;

 

        $teaser = $content[0];

 

                $teaser = '';

 

        $output .= $teaser;

 

                if ( $more ) {

                        $output .= '<span id="more-' . $post->ID . '"></span>' . $content[1];

                } else {

 

                                /**

                                 * Filters the Read More link text.

                                 * @param string $more_link_text    Read More text.

                                 */

                                $output .= apply_filters( 'the_content_more_link', ' <a href="' . get_permalink() . "#more-{$post->ID}\" class=\"more-link\">$more_link_text</a>", $more_link_text );

                        $output = force_balance_tags( $output );

                }

        }

 

 

        return $output;

}

 

/**

 * Determines whether the post has a custom excerpt.

 * For more information on this and similar theme functions, check out

 * Conditional Tags} article in the Theme Developer Handbook.

 *

 * @since 2.3.0

 */

function has_excerpt( $post = 0 ) {

        $post = get_post( $post );

}

 

/**

 *

 * @since 2.7.0

 *

}

 

/**

 *

 * The class names are many. If the post is a sticky, then the 'sticky'

 * class name. The class 'hentry' is always added to each post. If the post has a

 * eg 'category-foo' or 'my_custom_taxonomy-bar'.

 *

 * The 'post_tag' taxonomy is a special

 * $class parameter value, with the post ID as the last parameter.

 *

 * @since 2.7.0

 *

 */

function get_post_class( $class = '', $post_id = null ) {

        $post = get_post( $post_id );

        }

 

        $classes[] = 'post-' . $post->ID;

                $classes[] = $post->post_type;

        $classes[] = 'type-' . $post->post_type;

        $classes[] = 'status-' . $post->post_status;

 

        if ( post_type_supports( $post->post_type, 'post-formats' ) ) {

                $post_format = get_post_format( $post->ID );

 

                        $classes[] = 'format-' . sanitize_html_class( $post_format );

                        $classes[] = 'format-standard';

        }

 

        $post_password_required = post_password_required( $post->ID );

        $classes = array_map( 'esc_attr', $classes );

 

        /**

         *

         * @since 2.7.0

         *

         */

        $classes = apply_filters( 'post_class', $classes, $class, $post->ID );

 

}

 

/**

 *

 * @since 2.8.0

 *

 */

function body_class( $class = '' ) {

        echo 'class="' . join( ' ', get_body_class( $class ) ) . '"';

}

 

/**

 *

 * @since 2.8.0

 *

 * @global WP_Query $wp_query

 *

 */

function get_body_class( $class = '' ) {

        global $wp_query;

 

        $classes = array();

 

                $classes[] = 'rtl';

 

                $classes[] = 'home';

                $classes[] = 'blog';

                $classes[] = 'archive';

                $classes[] = 'date';

        if ( is_search() ) {

                $classes[] = 'search';

                $classes[] = $wp_query->posts ? 'search-results' : 'search-no-results';

        }

                $classes[] = 'paged';

                $classes[] = 'attachment';

                $classes[] = 'error404';

 

        if ( is_singular() ) {

                $post_type = $post->post_type;

 

                if ( is_page_template() ) {

                                if ( post_type_supports( $post->post_type, 'post-formats' ) ) {

                                        $post_format = get_post_format( $post->ID );

 

                                                $classes[] = 'single-format-' . sanitize_html_class( $post_format );

                                                $classes[] = 'single-format-standard';

                                }

                        }

                }

 

                if ( is_attachment() ) {

                        $mime_prefix = array( 'application/', 'image/', 'text/', 'audio/', 'video/', 'music/' );

                } elseif ( is_page() ) {

                        $classes[] = 'page';

 

                        $page_id = $wp_query->get_queried_object_id();

 

 

                        $classes[] = 'page-id-' . $page_id;

 

                                $classes[] = 'page-parent';

                        }

 

                if ( is_post_type_archive() ) {

                        $classes[] = 'post-type-archive';

                        $post_type = get_query_var( 'post_type' );

                                $post_type = reset( $post_type );

                        $classes[] = 'post-type-archive-' . sanitize_html_class( $post_type );

                } elseif ( is_author() ) {

                        $classes[] = 'author';

                        if ( isset( $author->user_nicename ) ) {

                                $classes[] = 'author-' . sanitize_html_class( $author->user_nicename, $author->ID );

                                $classes[] = 'author-' . $author->ID;

                        }

                } elseif ( is_category() ) {

                        $classes[] = 'category';

                        if ( isset( $cat->term_id ) ) {

                                $cat_class = sanitize_html_class( $cat->slug, $cat->term_id );

                                $classes[] = 'category-' . $cat->term_id;

                        }

                } elseif ( is_tag() ) {

                        $classes[] = 'tag';

                        if ( isset( $tag->term_id ) ) {

                                $tag_class = sanitize_html_class( $tag->slug, $tag->term_id );

                }

        }

 

                $classes[] = 'logged-in';

 

        if ( is_admin_bar_showing() ) {

                $classes[] = 'admin-bar';

                $classes[] = 'no-customize-support';

        }

 

                $classes[] = 'custom-background';

 

        if ( has_custom_logo() ) {

                $classes[] = 'wp-custom-logo';

 

        $page = $wp_query->get( 'page' );

 

                $page = $wp_query->get( 'paged' );

 

        if ( $page && $page > 1 && ! is_404() ) {

                $classes[] = 'paged-' . $page;

 

                        $classes[] = 'single-paged-' . $page;

                        $classes[] = 'page-paged-' . $page;

                        $classes[] = 'category-paged-' . $page;

                        $classes[] = 'tag-paged-' . $page;

                        $classes[] = 'date-paged-' . $page;

                        $classes[] = 'author-paged-' . $page;

                        $classes[] = 'search-paged-' . $page;

                        $classes[] = 'post-type-paged-' . $page;

        }

 

        if ( ! empty( $class ) ) {

                        $class = preg_split( '#\s+#', $class );

                $classes = array_merge( $classes, $class );

        } else {

                // Ensure that we always coerce class to being an array.

        $classes = array_map( 'esc_attr', $classes );

 

        /**

         *

         * @since 2.8.0

         *

         */

        $classes = apply_filters( 'body_class', $classes, $class );

 

 * @return bool false if a password is not required or the correct password cookie is present, true otherwise.

 */

function post_password_required( $post = null ) {

 

        if ( empty( $post->post_password ) ) {

                /** This filter is documented in wp-includes/post-template.php */

/**

 * The formatted output of a list of pages.

 *

 * Quicktag one or more times). This tag must be within The Loop.

 *

 * @since 1.2.0

 *

 * @global int $page

 * @global int $numpages

 *                                          Also prepended to the current item, which is not linked. Default empty.

 *     @type string       $link_after       HTML or text to append to each Pages link inside the `<a>` tag.

 *                                          Also appended to the current item, which is not linked. Default empty.

 *     @type string       $next_or_number   Indicates whether page numbers should be used. Valid values are number

 *                                          and next. Default is 'number'.

 *     @type string       $separator        Text between pagination links. Default is ' '.

        global $page, $numpages, $multipage, $more;

 

        $defaults = array(

                'after'            => '</p>',

                'link_before'      => '',

                'link_after'       => '',

                'next_or_number'   => 'number',

                'separator'        => ' ',

                'nextpagelink'     => __( 'Next page' ),

                'previouspagelink' => __( 'Previous page' ),

                'pagelink'         => '%',

        );

 

        $params = wp_parse_args( $args, $defaults );

                                $link = $r['link_before'] . str_replace( '%', $i, $r['pagelink'] ) . $r['link_after'];

                                if ( $i != $page || ! $more && 1 == $page ) {

                                        $link = _wp_link_page( $i ) . $link . '</a>';

                                }

                                /**

                                 * Filters the HTML output of individual page number links.

                        $output .= $r['after'];

                } elseif ( $more ) {

                        $output .= $r['before'];

                        if ( $prev > 0 ) {

                                $link = _wp_link_page( $prev ) . $r['link_before'] . $r['previouspagelink'] . $r['link_after'] . '</a>';

 

 */

function _wp_link_page( $i ) {

        global $wp_rewrite;

        $query_args = array();

 

        if ( 1 == $i ) {

                $url = get_permalink();

        } else {

                        $url = add_query_arg( 'page', $i, get_permalink() );

        }

 

        if ( is_preview() ) {

 

                if ( ( 'draft' !== $post->post_status ) && isset( $_GET['preview_id'], $_GET['preview_nonce'] ) ) {

                        $query_args['preview_nonce'] = wp_unslash( $_GET['preview_nonce'] );

                }

 

                $url = get_preview_post_link( $post, $query_args, $url );

        }

 

}

 

//

function post_custom( $key = '' ) {

        $custom = get_post_custom();

 

                return false;

}

 

/**

 *

 * @since 1.2.0

 *

 * @internal This will probably change at some point...

 */

function the_meta() {

        if ( $keys = get_post_custom_keys() ) {

                foreach ( (array) $keys as $key ) {

                        $keyt = trim( $key );

                        if ( is_protected_meta( $keyt, 'post' ) ) {

                        }

 

                        $values = array_map( 'trim', get_post_custom_values( $key ) );

 

                                /* translators: %s: Post custom field name */

                                sprintf( _x( '%s:', 'Post custom field name' ), $key ),

                                $value

                         * @param string $key   Meta key.

                         * @param string $value Meta value.

                         */

        }

}

 

//

 

/**

 *

 * @since 2.1.0

 * @since 4.2.0 The `$value_field` argument was added.

 * @since 4.3.0 The `$class` argument was added.

 *

 * @param array|string $args {

 *

 *     @type int          $depth                 Maximum depth. Default 0.

 *     @type int          $child_of              Page ID to retrieve child pages of. Default 0.

 */

function wp_dropdown_pages( $args = '' ) {

        $defaults = array(

        );

 

        $r = wp_parse_args( $args, $defaults );

 

        $output = '';

        // Back-compat with old system where both id and name were based on $name argument

        if ( empty( $r['id'] ) ) {

         * @param string $output HTML output for drop down list of pages.

         * @param array  $r      The parsed arguments array.

         * @param array  $pages  List of WP_Post objects returned by `get_pages()`

        $html = apply_filters( 'wp_dropdown_pages', $output, $r, $pages );

 

        if ( $r['echo'] ) {

}

 

/**

 *

 * @since 1.5.0

 * @since 4.7.0 Added the `item_spacing` argument.

 * @global WP_Query $wp_query

 *

 * @param array|string $args {

 *

 *     @type int          $child_of     Display only the sub-pages of a single page by ID. Default 0 (all pages).

 *     @type string       $authors      Comma-separated list of author IDs. Default empty (all authors).

                $r['item_spacing'] = $defaults['item_spacing'];

        }

 

        $current_page = 0;

 

        // sanitize, mostly to keep spaces out

 

        // Query pages.

        $r['hierarchical'] = 0;

 

        if ( ! empty( $pages ) ) {

                if ( $r['title_li'] ) {

/**

 * Displays or retrieves a list of pages with an optional home link.

 *

 * Check that function for more info on those arguments.

 *

 * @since 2.7.0

 * @since 4.7.0 Added the `item_spacing` argument.

 *

 * @param array|string $args {

 *

 *     @type string          $sort_column  How to sort the list of pages. Accepts post column names.

 *                                         Default 'menu_order, post_title'.

 *     @type string          $link_after   The HTML or text to append to $show_home text. Default empty.

 *     @type string          $before       The HTML or text to prepend to the menu. Default is '<ul>'.

 *     @type string          $after        The HTML or text to append to the menu. Default is '</ul>'.

 *     @type Walker          $walker       Walker instance to use for listing pages. Default empty (Walker_Page).

 * }

 * @return string|void HTML menu

                'item_spacing' => 'discard',

                'walker'       => '',

        );

 

        if ( ! in_array( $args['item_spacing'], array( 'preserve', 'discard' ) ) ) {

                // invalid value, fall back to default.

        $list_args = $args;

 

        // Show Home in the menu

                        $text = $args['show_home'];

                $class = '';

                        $class = 'class="current_page_item"';

                $menu .= '<li ' . $class . '><a href="' . home_url( '/' ) . '">' . $args['link_before'] . $text . $args['link_after'] . '</a></li>';

                // If the front page is a page, add it to the exclude list

                                $list_args['exclude'] .= ',';

                        } else {

                                $list_args['exclude'] = '';

                        }

                }

        }

 

        $list_args['title_li'] = '';

 

        $container = sanitize_text_field( $args['container'] );

 

                        'wp_page_menu' === $args['fallback_cb'] &&

                        'ul' !== $container ) {

                        $args['before'] = "<ul>{$n}";

                }

 

                $menu = $args['before'] . $menu . $args['after'];

         * @param array  $args An array of arguments.

         */

        $menu = apply_filters( 'wp_page_menu', $menu, $args );

                echo $menu;

                return $menu;

}

 

//

 * @return string

 */

function walk_page_tree( $pages, $depth, $current_page, $r ) {

                $walker = new Walker_Page;

                $walker = $r['walker'];

 

        foreach ( (array) $pages as $page ) {

                        $r['pages_with_children'][ $page->post_parent ] = true;

        }

 

}

 

/**

 */

function walk_page_dropdown_tree() {

        $args = func_get_args();

                $walker = new Walker_PageDropdown;

                $walker = $args[2]['walker'];

 

}

 

//

 * @param bool        $permalink    Optional, default is false. Whether to include permalink.

 */

function the_attachment_link( $id = 0, $fullsize = false, $deprecated = false, $permalink = false ) {

                _deprecated_argument( __FUNCTION__, '2.5.0' );

 

}

 

/**

         * Filters a retrieved attachment page link.

         *

         * @since 2.7.0

         *

         * @param string       $link_html The page link HTML output.

         * @param int          $id        Post ID.

         * @param bool         $permalink Whether to add permalink to image. Default false.

         * @param bool         $icon      Whether to include an icon. Default false.

         * @param string|bool  $text      If string, will be link text. Default false.

         */

}

 

/**

 * @param string $content

 * @return string

 */

        $post = get_post();

 

                return $content;

 

        if ( wp_attachment_is( 'video', $post ) ) {

                $meta = wp_get_attachment_metadata( get_the_ID() );

                $atts = array( 'src' => wp_get_attachment_url() );

                if ( ! empty( $meta['width'] ) && ! empty( $meta['height'] ) ) {

                        $atts['height'] = (int) $meta['height'];

                }

                if ( has_post_thumbnail() ) {

        } else {

                $p = '<p class="attachment">';

                // show the medium sized image representation of the attachment if available, and link to the raw file

                $p .= '</p>';

        }

 

 * @return string HTML content for password form for password protected post.

 */

function get_the_password_form( $post = 0 ) {

        $output = '<form action="' . esc_url( site_url( 'wp-login.php?action=postpass', 'login_post' ) ) . '" class="post-password-form" method="post">

        <p>' . __( 'This content is password protected. To view it please enter your password below:' ) . '</p>

        <p><label for="' . $label . '">' . __( 'Password:' ) . ' <input name="post_password" id="' . $label . '" type="password" size="20" /></label> <input type="submit" name="Submit" value="' . esc_attr_x( 'Enter', 'post password form' ) . '" /></p></form>

 * This template tag allows you to determine if you are in a page template.

 * You can optionally provide a template name or array of template names

 * and then the check will be specific to that template.

 * For more information on this and similar theme functions, check out

 * Conditional Tags} article in the Theme Developer Handbook.