Recent Posts For
Putting money back into your home can be a huge advantage for many people. While you may be sacrificing some money upfront to finance renovations, luckily you will be able to reacquire some cash on the back end if you ever sell your home.
We can be happy about many things: it’s going to be sunny today; your favorite team won the game; the item you’ve been eyeing went on sale. Joy is different. Joy is about deep relational connection, that according to clinical psychologist Dr. Jim Wilder, comes from being with people who are glad to be with you. We yearn for this joy, as we came to realize during Covid-19’s forced isolation. Gathering together is life-giving, and a fundamental consideration of residential design. How our homes accommodate or frustrate, how we like to socialize will have a profound impact on our happiness.
Putting money back into your home can be a huge advantage for many people. While you may be sacrificing some money upfront to finance renovations, luckily you will be able to reacquire some cash on the back end if you ever sell your home.
Putting money back into your home can be a huge advantage for many people. While you may be sacrificing some money upfront to finance renovations, luckily you will be able to reacquire some cash on the back end if you ever sell your home.
Few things you’ll do in your life are as simultaneously thrilling and terrifying as buying a home. To an extent, these conflicting excitements and fears are unavoidable. But the fears don’t have to be quite as bad as they’re sometimes made out to be — particularly with regard to pure finances.
Putting money back into your home can be a huge advantage for many people. While you may be sacrificing some money upfront to finance renovations, luckily you will be able to reacquire some cash on the back end if you ever sell your home.
Eco-friendly home upgrades can be beneficial for a variety of reasons for both you and the environment. From installing new systems and appliances to reducing our waste, every green choice we make helps us create a better environment for the planet. It’s important as...
Adding new home plans to your portfolio is risky. Will the design attract buyers? How much will that home cost to build? Design Basics’ Concierge Service is designed to help you minimize such risks. We know what is selling in terms of home design. Based on your goals...
Always on the go? Then you're sure to appreciate our Travel Center option, designed to keep everything handy and make packing a snap! You know where your suitcase has been...so you're probably not going to want to pack it on the clean bedspread! Our travel center was...
Are your dogs treated as full-fledged family members? For many of the 4 in 10 U.S. households with dogs, the answer is “Yes!” From floor plan layouts to material selections to innovative amenities, pet-centric homes make life better for Spot and his owners. Studies...
Current Dir: /var/www/designbasics/wp-includes/ [DIR] ID3 [ delete | rename ] [DIR] IXR [ delete | rename ] [DIR] PHPMailer [ delete | rename ] [DIR] Requests [ delete | rename ] [DIR] SimplePie [ delete | rename ] [DIR] Text [ delete | rename ] [FILE] admin-bar.php [ edit | delete | rename ] [DIR] assets [ delete | rename ] [FILE] atomlib.php [ edit | delete | rename ] [FILE] author-template.php [ edit | delete | rename ] [DIR] block-bindings [ delete | rename ] [FILE] block-bindings.php [ edit | delete | rename ] [FILE] block-editor.php [ edit | delete | rename ] [FILE] block-i18n.json [ edit | delete | rename ] [DIR] block-patterns [ delete | rename ] [FILE] block-patterns.php [ edit | delete | rename ] [DIR] block-supports [ delete | rename ] [FILE] block-template-utils.php [ edit | delete | rename ] [FILE] block-template.php [ edit | delete | rename ] [DIR] blocks [ delete | rename ] [FILE] blocks.php [ edit | delete | rename ] [FILE] bookmark-template.php [ edit | delete | rename ] [FILE] bookmark.php [ edit | delete | rename ] [FILE] cache-compat.php [ edit | delete | rename ] [FILE] cache.php [ edit | delete | rename ] [FILE] canonical.php [ edit | delete | rename ] [FILE] capabilities.php [ edit | delete | rename ] [FILE] category-template.php [ edit | delete | rename ] [FILE] category.php [ edit | delete | rename ] [DIR] certificates [ delete | rename ] [FILE] class-IXR.php [ edit | delete | rename ] [FILE] class-avif-info.php [ edit | delete | rename ] [FILE] class-feed.php [ edit | delete | rename ] [FILE] class-http.php [ edit | delete | rename ] [FILE] class-json.php [ edit | delete | rename ] [FILE] class-oembed.php [ edit | delete | rename ] [FILE] class-phpass.php [ edit | delete | rename ] [FILE] class-phpmailer.php [ edit | delete | rename ] [FILE] class-pop3.php [ edit | delete | rename ] [FILE] class-requests.php [ edit | delete | rename ] [FILE] class-simplepie.php [ edit | delete | rename ] [FILE] class-smtp.php [ edit | delete | rename ] [FILE] class-snoopy.php [ edit | delete | rename ] [FILE] class-walker-category-dropdown.php [ edit | delete | rename ] [FILE] class-walker-category.php [ edit | delete | rename ] [FILE] class-walker-comment.php [ edit | delete | rename ] [FILE] class-walker-nav-menu.php [ edit | delete | rename ] [FILE] class-walker-page-dropdown.php [ edit | delete | rename ] [FILE] class-walker-page.php [ edit | delete | rename ] [FILE] class-wp-admin-bar.php [ edit | delete | rename ] [FILE] class-wp-ajax-response.php [ edit | delete | rename ] [FILE] class-wp-application-passwords.php [ edit | delete | rename ] [FILE] class-wp-block-bindings-registry.php [ edit | delete | rename ] [FILE] class-wp-block-bindings-source.php [ edit | delete | rename ] [FILE] class-wp-block-editor-context.php [ edit | delete | rename ] [FILE] class-wp-block-list.php [ edit | delete | rename ] [FILE] class-wp-block-parser-block.php [ edit | delete | rename ] [FILE] class-wp-block-parser-frame.php [ edit | delete | rename ] [FILE] class-wp-block-parser.php [ edit | delete | rename ] [FILE] class-wp-block-pattern-categories-registry.php [ edit | delete | rename ] [FILE] class-wp-block-patterns-registry.php [ edit | delete | rename ] [FILE] class-wp-block-styles-registry.php [ edit | delete | rename ] [FILE] class-wp-block-supports.php [ edit | delete | rename ] [FILE] class-wp-block-template.php [ edit | delete | rename ] [FILE] class-wp-block-type-registry.php [ edit | delete | rename ] [FILE] class-wp-block-type.php [ edit | delete | rename ] [FILE] class-wp-block.php [ edit | delete | rename ] [FILE] class-wp-classic-to-block-menu-converter.php [ edit | delete | rename ] [FILE] class-wp-comment-query.php [ edit | delete | rename ] [FILE] class-wp-comment.php [ edit | delete | rename ] [FILE] class-wp-customize-control.php [ edit | delete | rename ] [FILE] class-wp-customize-manager.php [ edit | delete | rename ] [FILE] class-wp-customize-nav-menus.php [ edit | delete | rename ] [FILE] class-wp-customize-panel.php [ edit | delete | rename ] [FILE] class-wp-customize-section.php [ edit | delete | rename ] [FILE] class-wp-customize-setting.php [ edit | delete | rename ] [FILE] class-wp-customize-widgets.php [ edit | delete | rename ] [FILE] class-wp-date-query.php [ edit | delete | rename ] [FILE] class-wp-dependencies.php [ edit | delete | rename ] [FILE] class-wp-dependency.php [ edit | delete | rename ] [FILE] class-wp-duotone.php [ edit | delete | rename ] [FILE] class-wp-editor.php [ edit | delete | rename ] [FILE] class-wp-embed.php [ edit | delete | rename ] [FILE] class-wp-error.php [ edit | delete | rename ] [FILE] class-wp-fatal-error-handler.php [ edit | delete | rename ] [FILE] class-wp-feed-cache-transient.php [ edit | delete | rename ] [FILE] class-wp-feed-cache.php [ edit | delete | rename ] [FILE] class-wp-hook.php [ edit | delete | rename ] [FILE] class-wp-http-cookie.php [ edit | delete | rename ] [FILE] class-wp-http-curl.php [ edit | delete | rename ] [FILE] class-wp-http-encoding.php [ edit | delete | rename ] [FILE] class-wp-http-ixr-client.php [ edit | delete | rename ] [FILE] class-wp-http-proxy.php [ edit | delete | rename ] [FILE] class-wp-http-requests-hooks.php [ edit | delete | rename ] [FILE] class-wp-http-requests-response.php [ edit | delete | rename ] [FILE] class-wp-http-response.php [ edit | delete | rename ] [FILE] class-wp-http-streams.php [ edit | delete | rename ] [FILE] class-wp-http.php [ edit | delete | rename ] [FILE] class-wp-image-editor-gd.php [ edit | delete | rename ] [FILE] class-wp-image-editor-imagick.php [ edit | delete | rename ] [FILE] class-wp-image-editor.php [ edit | delete | rename ] [FILE] class-wp-list-util.php [ edit | delete | rename ] [FILE] class-wp-locale-switcher.php [ edit | delete | rename ] [FILE] class-wp-locale.php [ edit | delete | rename ] [FILE] class-wp-matchesmapregex.php [ edit | delete | rename ] [FILE] class-wp-meta-query.php [ edit | delete | rename ] [FILE] class-wp-metadata-lazyloader.php [ edit | delete | rename ] [FILE] class-wp-navigation-fallback.php [ edit | delete | rename ] [FILE] class-wp-network-query.php [ edit | delete | rename ] [FILE] class-wp-network.php [ edit | delete | rename ] [FILE] class-wp-object-cache.php [ edit | delete | rename ] [FILE] class-wp-oembed-controller.php [ edit | delete | rename ] [FILE] class-wp-oembed.php [ edit | delete | rename ] [FILE] class-wp-paused-extensions-storage.php [ edit | delete | rename ] [FILE] class-wp-plugin-dependencies.php [ edit | delete | rename ] [FILE] class-wp-post-type.php [ edit | delete | rename ] [FILE] class-wp-post.php [ edit | delete | rename ] [FILE] class-wp-query.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode-cookie-service.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode-email-service.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode-key-service.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode-link-service.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode.php [ edit | delete | rename ] [FILE] class-wp-rewrite.php [ edit | delete | rename ] [FILE] class-wp-role.php [ edit | delete | rename ] [FILE] class-wp-roles.php [ edit | delete | rename ] [FILE] class-wp-script-modules.php [ edit | delete | rename ] [FILE] class-wp-scripts.php [ edit | delete | rename ] [FILE] class-wp-session-tokens.php [ edit | delete | rename ] [FILE] class-wp-simplepie-file.php [ edit | delete | rename ] [FILE] class-wp-simplepie-sanitize-kses.php [ edit | delete | rename ] [FILE] class-wp-site-query.php [ edit | delete | rename ] [FILE] class-wp-site.php [ edit | delete | rename ] [FILE] class-wp-styles.php [ edit | delete | rename ] [FILE] class-wp-tax-query.php [ edit | delete | rename ] [FILE] class-wp-taxonomy.php [ edit | delete | rename ] [FILE] class-wp-term-query.php [ edit | delete | rename ] [FILE] class-wp-term.php [ edit | delete | rename ] [FILE] class-wp-text-diff-renderer-inline.php [ edit | delete | rename ] [FILE] class-wp-text-diff-renderer-table.php [ edit | delete | rename ] [FILE] class-wp-textdomain-registry.php [ edit | delete | rename ] [FILE] class-wp-theme-json-data.php [ edit | delete | rename ] [FILE] class-wp-theme-json-resolver.php [ edit | delete | rename ] [FILE] class-wp-theme-json-schema.php [ edit | delete | rename ] [FILE] class-wp-theme-json.php [ edit | delete | rename ] [FILE] class-wp-theme.php [ edit | delete | rename ] [FILE] class-wp-token-map.php [ edit | delete | rename ] [FILE] class-wp-user-meta-session-tokens.php [ edit | delete | rename ] [FILE] class-wp-user-query.php [ edit | delete | rename ] [FILE] class-wp-user-request.php [ edit | delete | rename ] [FILE] class-wp-user.php [ edit | delete | rename ] [FILE] class-wp-walker.php [ edit | delete | rename ] [FILE] class-wp-widget-factory.php [ edit | delete | rename ] [FILE] class-wp-widget.php [ edit | delete | rename ] [FILE] class-wp-xmlrpc-server.php [ edit | delete | rename ] [FILE] class-wp.php [ edit | delete | rename ] [FILE] class-wpdb.php [ edit | delete | rename ] [FILE] class.wp-dependencies.php [ edit | delete | rename ] [FILE] class.wp-scripts.php [ edit | delete | rename ] [FILE] class.wp-styles.php [ edit | delete | rename ] [FILE] comment-template.php [ edit | delete | rename ] [FILE] comment.php [ edit | delete | rename ] [FILE] compat.php [ edit | delete | rename ] [FILE] cron.php [ edit | delete | rename ] [DIR] css [ delete | rename ] [DIR] customize [ delete | rename ] [FILE] date.php [ edit | delete | rename ] [FILE] default-constants.php [ edit | delete | rename ] [FILE] default-filters.php [ edit | delete | rename ] [FILE] default-widgets.php [ edit | delete | rename ] [FILE] deprecated.php [ edit | delete | rename ] [FILE] embed-template.php [ edit | delete | rename ] [FILE] embed.php [ edit | delete | rename ] [FILE] error-protection.php [ edit | delete | rename ] [FILE] feed-atom-comments.php [ edit | delete | rename ] [FILE] feed-atom.php [ edit | delete | rename ] [FILE] feed-rdf.php [ edit | delete | rename ] [FILE] feed-rss.php [ edit | delete | rename ] [FILE] feed-rss2-comments.php [ edit | delete | rename ] [FILE] feed-rss2.php [ edit | delete | rename ] [FILE] feed.php [ edit | delete | rename ] [DIR] fonts [ delete | rename ] [FILE] fonts.php [ edit | delete | rename ] [FILE] formatting.php [ edit | delete | rename ] [FILE] functions.php [ edit | delete | rename ] [FILE] functions.wp-scripts.php [ edit | delete | rename ] [FILE] functions.wp-styles.php [ edit | delete | rename ] [FILE] general-template.php [ edit | delete | rename ] [FILE] global-styles-and-settings.php [ edit | delete | rename ] [DIR] html-api [ delete | rename ] [FILE] http.php [ edit | delete | rename ] [FILE] https-detection.php [ edit | delete | rename ] [FILE] https-migration.php [ edit | delete | rename ] [DIR] images [ delete | rename ] [DIR] interactivity-api [ delete | rename ] [DIR] js [ delete | rename ] [FILE] kses.php [ edit | delete | rename ] [DIR] l10n [ delete | rename ] [FILE] l10n.php [ edit | delete | rename ] [FILE] link-template.php [ edit | delete | rename ] [FILE] load.php [ edit | delete | rename ] [FILE] locale.php [ edit | delete | rename ] [FILE] media-template.php [ edit | delete | rename ] [FILE] media.php [ edit | delete | rename ] [FILE] meta.php [ edit | delete | rename ] [FILE] ms-blogs.php [ edit | delete | rename ] [FILE] ms-default-constants.php [ edit | delete | rename ] [FILE] ms-default-filters.php [ edit | delete | rename ] [FILE] ms-deprecated.php [ edit | delete | rename ] [FILE] ms-files.php [ edit | delete | rename ] [FILE] ms-functions.php [ edit | delete | rename ] [FILE] ms-load.php [ edit | delete | rename ] [FILE] ms-network.php [ edit | delete | rename ] [FILE] ms-settings.php [ edit | delete | rename ] [FILE] ms-site.php [ edit | delete | rename ] [FILE] nav-menu-template.php [ edit | delete | rename ] [FILE] nav-menu.php [ edit | delete | rename ] [FILE] option.php [ edit | delete | rename ] [DIR] php-compat [ delete | rename ] [FILE] pluggable-deprecated.php [ edit | delete | rename ] [FILE] pluggable.php [ edit | delete | rename ] [FILE] plugin.php [ edit | delete | rename ] [DIR] pomo [ delete | rename ] [FILE] post-formats.php [ edit | delete | rename ] [FILE] post-template.php [ edit | delete | rename ] [FILE] post-thumbnail-template.php [ edit | delete | rename ] [FILE] post.php [ edit | delete | rename ] [FILE] query.php [ edit | delete | rename ] [FILE] registration-functions.php [ edit | delete | rename ] [FILE] registration.php [ edit | delete | rename ] [DIR] rest-api [ delete | rename ] [FILE] rest-api.php [ edit | delete | rename ] [FILE] revision.php [ edit | delete | rename ] [FILE] rewrite.php [ edit | delete | rename ] [FILE] robots-template.php [ edit | delete | rename ] [FILE] rss-functions.php [ edit | delete | rename ] [FILE] rss.php [ edit | delete | rename ] [FILE] script-loader.php [ edit | delete | rename ] [FILE] script-modules.php [ edit | delete | rename ] [FILE] session.php [ edit | delete | rename ] [FILE] shortcodes.php [ edit | delete | rename ] [DIR] sitemaps [ delete | rename ] [FILE] sitemaps.php [ edit | delete | rename ] [DIR] sodium_compat [ delete | rename ] [FILE] spl-autoload-compat.php [ edit | delete | rename ] [DIR] style-engine [ delete | rename ] [FILE] style-engine.php [ edit | delete | rename ] [FILE] taxonomy.php [ edit | delete | rename ] [FILE] template-canvas.php [ edit | delete | rename ] [FILE] template-loader.php [ edit | delete | rename ] [FILE] template.php [ edit | delete | rename ] [DIR] theme-compat [ delete | rename ] [FILE] theme-i18n.json [ edit | delete | rename ] [FILE] theme-previews.php [ edit | delete | rename ] [FILE] theme-templates.php [ edit | delete | rename ] [FILE] theme.json [ edit | delete | rename ] [FILE] theme.php [ edit | delete | rename ] [FILE] update.php [ edit | delete | rename ] [FILE] user.php [ edit | delete | rename ] [FILE] vars.php [ edit | delete | rename ] [FILE] version.php [ edit | delete | rename ] [DIR] widgets [ delete | rename ] [FILE] widgets.php [ edit | delete | rename ] [FILE] wp-db.php [ edit | delete | rename ] [FILE] wp-diff.php [ edit | delete | rename ] Viewing: /var/www/designbasics/wp-includes/bookmark-template.php <?php /** * Bookmark Template Functions for usage in Themes. * * @package WordPress * @subpackage Template */ /** * The formatted output of a list of bookmarks. * * The $bookmarks array must contain bookmark objects and will be iterated over * to retrieve the bookmark to be used in the output. * * The output is formatted as HTML with no way to change that format. However, * what is between, before, and after can be changed. The link itself will be * HTML. * * This function is used internally by wp_list_bookmarks() and should not be * used by themes. * * @since 2.1.0 * @access private * * @param array $bookmarks List of bookmarks to traverse. * @param string|array $args { * Optional. Bookmarks arguments. * * @type int|bool $show_updated Whether to show the time the bookmark was last updated. * Accepts 1|true or 0|false. Default 0|false. * @type int|bool $show_description Whether to show the bookmark description. Accepts 1|true, * Accepts 1|true or 0|false. Default 0|false. * @type int|bool $show_images Whether to show the link image if available. Accepts 1|true * or 0|false. Default 1|true. * @type int|bool $show_name Whether to show link name if available. Accepts 1|true or * 0|false. Default 0|false. * @type string $before The HTML or text to prepend to each bookmark. Default `<li>`. * @type string $after The HTML or text to append to each bookmark. Default `</li>`. * @type string $link_before The HTML or text to prepend to each bookmark inside the anchor * tags. Default empty. * @type string $link_after The HTML or text to append to each bookmark inside the anchor * tags. Default empty. * @type string $between The string for use in between the link, description, and image. * Default "\n". * @type int|bool $show_rating Whether to show the link rating. Accepts 1|true or 0|false. * Default 0|false. * * } * @return string Formatted output in HTML */ function _walk_bookmarks( $bookmarks, $args = '' ) { $defaults = array( 'show_updated' => 0, 'show_description' => 0, 'show_images' => 1, 'show_name' => 0, 'before' => '<li>', 'after' => '</li>', 'between' => "\n", 'show_rating' => 0, 'link_before' => '', 'link_after' => '', ); $parsed_args = wp_parse_args( $args, $defaults ); $output = ''; // Blank string to start with. foreach ( (array) $bookmarks as $bookmark ) { if ( ! isset( $bookmark->recently_updated ) ) { $bookmark->recently_updated = false; } $output .= $parsed_args['before']; if ( $parsed_args['show_updated'] && $bookmark->recently_updated ) { $output .= '<em>'; } $the_link = '#'; if ( ! empty( $bookmark->link_url ) ) { $the_link = esc_url( $bookmark->link_url ); } $desc = esc_attr( sanitize_bookmark_field( 'link_description', $bookmark->link_description, $bookmark->link_id, 'display' ) ); $name = esc_attr( sanitize_bookmark_field( 'link_name', $bookmark->link_name, $bookmark->link_id, 'display' ) ); $title = $desc; if ( $parsed_args['show_updated'] ) { if ( ! str_starts_with( $bookmark->link_updated_f, '00' ) ) { $title .= ' ('; $title .= sprintf( /* translators: %s: Date and time of last update. */ __( 'Last updated: %s' ), gmdate( get_option( 'links_updated_date_format' ), $bookmark->link_updated_f + ( get_option( 'gmt_offset' ) * HOUR_IN_SECONDS ) ) ); $title .= ')'; } } $alt = ' alt="' . $name . ( $parsed_args['show_description'] ? ' ' . $title : '' ) . '"'; if ( '' !== $title ) { $title = ' title="' . $title . '"'; } $rel = $bookmark->link_rel; $target = $bookmark->link_target; if ( '' !== $target ) { if ( is_string( $rel ) && '' !== $rel ) { if ( ! str_contains( $rel, 'noopener' ) ) { $rel = trim( $rel ) . ' noopener'; } } else { $rel = 'noopener'; } $target = ' target="' . $target . '"'; } if ( '' !== $rel ) { $rel = ' rel="' . esc_attr( $rel ) . '"'; } $output .= '<a href="' . $the_link . '"' . $rel . $title . $target . '>'; $output .= $parsed_args['link_before']; if ( '' !== $bookmark->link_image && $parsed_args['show_images'] ) { if ( str_starts_with( $bookmark->link_image, 'http' ) ) { $output .= '<img src="' . $bookmark->link_image . '"' . $alt . $title . ' />'; } else { // If it's a relative path. $output .= '<img src="' . get_option( 'siteurl' ) . $bookmark->link_image . '"' . $alt . $title . ' />'; } if ( $parsed_args['show_name'] ) { $output .= " $name"; } } else { $output .= $name; } $output .= $parsed_args['link_after']; $output .= '</a>'; if ( $parsed_args['show_updated'] && $bookmark->recently_updated ) { $output .= '</em>'; } if ( $parsed_args['show_description'] && '' !== $desc ) { $output .= $parsed_args['between'] . $desc; } if ( $parsed_args['show_rating'] ) { $output .= $parsed_args['between'] . sanitize_bookmark_field( 'link_rating', $bookmark->link_rating, $bookmark->link_id, 'display' ); } $output .= $parsed_args['after'] . "\n"; } // End while. return $output; } /** * Retrieves or echoes all of the bookmarks. * * List of default arguments are as follows: * * These options define how the Category name will appear before the category * links are displayed, if 'categorize' is 1. If 'categorize' is 0, then it will * display for only the 'title_li' string and only if 'title_li' is not empty. * * @since 2.1.0 * * @see _walk_bookmarks() * * @param string|array $args { * Optional. String or array of arguments to list bookmarks. * * @type string $orderby How to order the links by. Accepts post fields. Default 'name'. * @type string $order Whether to order bookmarks in ascending or descending order. * Accepts 'ASC' (ascending) or 'DESC' (descending). Default 'ASC'. * @type int $limit Amount of bookmarks to display. Accepts 1+ or -1 for all. * Default -1. * @type string $category Comma-separated list of category IDs to include links from. * Default empty. * @type string $category_name Category to retrieve links for by name. Default empty. * @type int|bool $hide_invisible Whether to show or hide links marked as 'invisible'. Accepts * 1|true or 0|false. Default 1|true. * @type int|bool $show_updated Whether to display the time the bookmark was last updated. * Accepts 1|true or 0|false. Default 0|false. * @type int|bool $echo Whether to echo or return the formatted bookmarks. Accepts * 1|true (echo) or 0|false (return). Default 1|true. * @type int|bool $categorize Whether to show links listed by category or in a single column. * Accepts 1|true (by category) or 0|false (one column). Default 1|true. * @type int|bool $show_description Whether to show the bookmark descriptions. Accepts 1|true or 0|false. * Default 0|false. * @type string $title_li What to show before the links appear. Default 'Bookmarks'. * @type string $title_before The HTML or text to prepend to the $title_li string. Default '<h2>'. * @type string $title_after The HTML or text to append to the $title_li string. Default '</h2>'. * @type string|array $class The CSS class or an array of classes to use for the $title_li. * Default 'linkcat'. * @type string $category_before The HTML or text to prepend to $title_before if $categorize is true. * String must contain '%id' and '%class' to inherit the category ID and * the $class argument used for formatting in themes. * Default '<li id="%id" class="%class">'. * @type string $category_after The HTML or text to append to $title_after if $categorize is true. * Default '</li>'. * @type string $category_orderby How to order the bookmark category based on term scheme if $categorize * is true. Default 'name'. * @type string $category_order Whether to order categories in ascending or descending order if * $categorize is true. Accepts 'ASC' (ascending) or 'DESC' (descending). * Default 'ASC'. * } * @return void|string Void if 'echo' argument is true, HTML list of bookmarks if 'echo' is false. */ function wp_list_bookmarks( $args = '' ) { $defaults = array( 'orderby' => 'name', 'order' => 'ASC', 'limit' => -1, 'category' => '', 'exclude_category' => '', 'category_name' => '', 'hide_invisible' => 1, 'show_updated' => 0, 'echo' => 1, 'categorize' => 1, 'title_li' => __( 'Bookmarks' ), 'title_before' => '<h2>', 'title_after' => '</h2>', 'category_orderby' => 'name', 'category_order' => 'ASC', 'class' => 'linkcat', 'category_before' => '<li id="%id" class="%class">', 'category_after' => '</li>', ); $parsed_args = wp_parse_args( $args, $defaults ); $output = ''; if ( ! is_array( $parsed_args['class'] ) ) { $parsed_args['class'] = explode( ' ', $parsed_args['class'] ); } $parsed_args['class'] = array_map( 'sanitize_html_class', $parsed_args['class'] ); $parsed_args['class'] = trim( implode( ' ', $parsed_args['class'] ) ); if ( $parsed_args['categorize'] ) { $cats = get_terms( array( 'taxonomy' => 'link_category', 'name__like' => $parsed_args['category_name'], 'include' => $parsed_args['category'], 'exclude' => $parsed_args['exclude_category'], 'orderby' => $parsed_args['category_orderby'], 'order' => $parsed_args['category_order'], 'hierarchical' => 0, ) ); if ( empty( $cats ) ) { $parsed_args['categorize'] = false; } } if ( $parsed_args['categorize'] ) { // Split the bookmarks into ul's for each category. foreach ( (array) $cats as $cat ) { $params = array_merge( $parsed_args, array( 'category' => $cat->term_id ) ); $bookmarks = get_bookmarks( $params ); if ( empty( $bookmarks ) ) { continue; } $output .= str_replace( array( '%id', '%class' ), array( "linkcat-$cat->term_id", $parsed_args['class'] ), $parsed_args['category_before'] ); /** * Filters the category name. * * @since 2.2.0 * * @param string $cat_name The category name. */ $catname = apply_filters( 'link_category', $cat->name ); $output .= $parsed_args['title_before']; $output .= $catname; $output .= $parsed_args['title_after']; $output .= "\n\t<ul class='xoxo blogroll'>\n"; $output .= _walk_bookmarks( $bookmarks, $parsed_args ); $output .= "\n\t</ul>\n"; $output .= $parsed_args['category_after'] . "\n"; } } else { // Output one single list using title_li for the title. $bookmarks = get_bookmarks( $parsed_args ); if ( ! empty( $bookmarks ) ) { if ( ! empty( $parsed_args['title_li'] ) ) { $output .= str_replace( array( '%id', '%class' ), array( 'linkcat-' . $parsed_args['category'], $parsed_args['class'] ), $parsed_args['category_before'] ); $output .= $parsed_args['title_before']; $output .= $parsed_args['title_li']; $output .= $parsed_args['title_after']; $output .= "\n\t<ul class='xoxo blogroll'>\n"; $output .= _walk_bookmarks( $bookmarks, $parsed_args ); $output .= "\n\t</ul>\n"; $output .= $parsed_args['category_after'] . "\n"; } else { $output .= _walk_bookmarks( $bookmarks, $parsed_args ); } } } /** * Filters the bookmarks list before it is echoed or returned. * * @since 2.5.0 * * @param string $html The HTML list of bookmarks. */ $html = apply_filters( 'wp_list_bookmarks', $output ); if ( $parsed_args['echo'] ) { echo $html; } else { return $html; } }
