WordPress.org
Get WordPress

Make WordPress Core

Changeset 13093


Ignore:
Timestamp:
02/13/2010 06:39:51 AM (17 years ago)
Author:
nacin
Message:

Move deprecated functions to deprecated.php. Deprecate get_the_attachment_link() for wp_get_attachment_link(), get_attachment_icon_src() for wp_get_attachment_image_src(),
get_attachment_icon() and get_attachment_innerHTML() for wp_get_attachment_image(), get_link() for get_bookmark(). Add missing deprecated version numbers. Add inline documentation to pluggable functions that are deprecated. See #11388

Location:
trunk/wp-includes
Files:
4 edited

Legend:

Unmodified
Added
Removed

  • trunk/wp-includes/bookmark.php

    r13017 r13093  
    7878
    7979        return sanitize_bookmark_field($field, $bookmark->$field, $bookmark->link_id, $context);
    80 }
    81 
    82 /**
    83  * Retrieve bookmark data based on ID.
    84  *
    85  * @since 2.0.0
    86  * @deprecated Use get_bookmark()
    87  * @see get_bookmark()
    88  *
    89  * @param int $bookmark_id ID of link
    90  * @param string $output Either OBJECT, ARRAY_N, or ARRAY_A
    91  * @return object|array
    92  */
    93 function get_link($bookmark_id, $output = OBJECT, $filter = 'raw') {
    94         return get_bookmark($bookmark_id, $output, $filter);
    9580}
    9681

  • trunk/wp-includes/deprecated.php

    r12871 r13093  
    126126        global $wp_query, $post;
    127127
    128         _deprecated_function( __FUNCTION__, '1.5', __('new WordPress Loop')  );
     128        _deprecated_function( __FUNCTION__, '1.5', __('new WordPress Loop') );
    129129
    130130        // Since the old style loop is being used, advance the query iterator here.
    … …  
    318318        $post_author_data = get_userdata($post->post_author);
    319319
    320         if ( (($user_id == $post_author_data->ID) && !($post->post_status == 'publish' &&  $author_data->user_level < 2))
     320        if ( (($user_id == $post_author_data->ID) && !($post->post_status == 'publish' && $author_data->user_level < 2))
    321321                         || ($author_data->user_level > $post_author_data->user_level)
    322322                         || ($author_data->user_level >= 10) ) {
    … …  
    488488 *
    489489 * @since 1.0.1
     490 * @deprecated 2.1
    490491 * @deprecated Use wp_list_bookmarks()
    491492 * @see wp_list_bookmarks()
    … …  
    662663 *
    663664 * @since 0.71
     665 * @deprecated 2.1
    664666 * @deprecated No alternative function available
    665667 *
    … …  
    668670 */
    669671function get_autotoggle($id = 0) {
    670         _deprecated_function( __FUNCTION__, '2.1'  );
     672        _deprecated_function( __FUNCTION__, '2.1' );
    671673        return 0;
    672674}
    … …  
    742744/**
    743745 * @since 0.71
     746 * @deprecated 2.1
    744747 * @deprecated Use wp_dropdown_categories()
    745748 * @see wp_dropdown_categories()
    … …  
    932935 *
    933936 * @since 0.71
     937 * @deprecated 2.3
    934938 * @deprecated Use the_permalink_rss()
    935939 * @see the_permalink_rss()
    … …  
    938942 */
    939943function permalink_single_rss($deprecated = '') {
    940         _deprecated_function(__FUNCTION__, '0.0', 'the_permalink_rss()');
     944        _deprecated_function( __FUNCTION__, '0.0', 'the_permalink_rss()' );
    941945        the_permalink_rss();
    942946}
    … …  
    947951 * @see get_links() for argument information that can be used in $args
    948952 * @since 1.0.1
    949  * @deprecated Use get_bookmarks()
    950  * @see get_bookmarks()
     953 * @deprecated 2.1
     954 * @deprecated Use wp_list_bookmarks()
     955 * @see wp_list_bookmarks()
    951956 *
    952957 * @param string $args a query string
    … …  
    954959 */
    955960function wp_get_links($args = '') {
    956         _deprecated_function(__FUNCTION__, '0.0', 'wp_list_bookmarks()');
     961        _deprecated_function( __FUNCTION__, '0.0', 'wp_list_bookmarks()' );
    957962
    958963        if ( strpos( $args, '=' ) === false ) {
    … …  
    986991 *
    987992 * @since 0.71
     993 * @deprecated 2.1
    988994 * @deprecated Use get_bookmarks()
    989995 * @see get_bookmarks()
    … …  
    11511157 */
    11521158function links_popup_script($text = 'Links', $width=400, $height=400, $file='links.all.php', $count = true) {
    1153         _deprecated_function( __FUNCTION__, '2.1'  );
     1159        _deprecated_function( __FUNCTION__, '2.1' );
    11541160
    11551161        if ( $count )
    … …  
    13071313*/
    13081314function gzip_compression() {
    1309         _deprecated_function( __FUNCTION__, '2.5', '' );
     1315        _deprecated_function( __FUNCTION__, '2.5' );
    13101316        return false;
    13111317}
    … …  
    13941400 */
    13951401function get_the_author_description() {
    1396         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'description\')'  );
     1402        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'description\')' );
    13971403        return get_the_author_meta('description');
    13981404}
    … …  
    14071413 */
    14081414function the_author_description() {
    1409         _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'description\')'  );
     1415        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'description\')' );
    14101416        the_author_meta('description');
    14111417}
    … …  
    14221428 */
    14231429function get_the_author_login() {
    1424         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'login\')'  );
     1430        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'login\')' );
    14251431        return get_the_author_meta('login');
    14261432}
    … …  
    14351441 */
    14361442function the_author_login() {
    1437         _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'login\')'  );
     1443        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'login\')' );
    14381444        the_author_meta('login');
    14391445}
    … …  
    14501456 */
    14511457function get_the_author_firstname() {
    1452         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'first_name\')'  );
     1458        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'first_name\')' );
    14531459        return get_the_author_meta('first_name');
    14541460}
    … …  
    14631469 */
    14641470function the_author_firstname() {
    1465         _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'first_name\')'  );
     1471        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'first_name\')' );
    14661472        the_author_meta('first_name');
    14671473}
    … …  
    14781484 */
    14791485function get_the_author_lastname() {
    1480         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'last_name\')'  );
     1486        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'last_name\')' );
    14811487        return get_the_author_meta('last_name');
    14821488}
    … …  
    14911497 */
    14921498function the_author_lastname() {
    1493         _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'last_name\')'  );
     1499        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'last_name\')' );
    14941500        the_author_meta('last_name');
    14951501}
    … …  
    15061512 */
    15071513function get_the_author_nickname() {
    1508         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'nickname\')'  );
     1514        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'nickname\')' );
    15091515        return get_the_author_meta('nickname');
    15101516}
    … …  
    15191525 */
    15201526function the_author_nickname() {
    1521         _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'nickname\')'  );
     1527        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'nickname\')' );
    15221528        the_author_meta('nickname');
    15231529}
    … …  
    15341540 */
    15351541function get_the_author_email() {
    1536         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'email\')'  );
     1542        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'email\')' );
    15371543        return get_the_author_meta('email');
    15381544}
    … …  
    15471553 */
    15481554function the_author_email() {
    1549         _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'email\')'  );
     1555        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'email\')' );
    15501556        the_author_meta('email');
    15511557}
    … …  
    15621568 */
    15631569function get_the_author_icq() {
    1564         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'icq\')'  );
     1570        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'icq\')' );
    15651571        return get_the_author_meta('icq');
    15661572}
    … …  
    15751581 */
    15761582function the_author_icq() {
    1577         _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'icq\')'  );
     1583        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'icq\')' );
    15781584        the_author_meta('icq');
    15791585}
    … …  
    15901596 */
    15911597function get_the_author_yim() {
    1592         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'yim\')'  );
     1598        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'yim\')' );
    15931599        return get_the_author_meta('yim');
    15941600}
    … …  
    16031609 */
    16041610function the_author_yim() {
    1605         _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'yim\')'  );
     1611        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'yim\')' );
    16061612        the_author_meta('yim');
    16071613}
    … …  
    16181624 */
    16191625function get_the_author_msn() {
    1620         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'msn\')'  );
     1626        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'msn\')' );
    16211627        return get_the_author_meta('msn');
    16221628}
    … …  
    16311637 */
    16321638function the_author_msn() {
    1633         _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'msn\')'  );
     1639        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'msn\')' );
    16341640        the_author_meta('msn');
    16351641}
    … …  
    16461652 */
    16471653function get_the_author_aim() {
    1648         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'aim\')'  );
     1654        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'aim\')' );
    16491655        return get_the_author_meta('aim');
    16501656}
    … …  
    16591665 */
    16601666function the_author_aim() {
    1661         _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'aim\')'  );
     1667        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'aim\')' );
    16621668        the_author_meta('aim');
    16631669}
    … …  
    16751681 */
    16761682function get_author_name( $auth_id = false ) {
    1677         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'display_name\')'  );
     1683        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'display_name\')' );
    16781684        return get_the_author_meta('display_name', $auth_id);
    16791685}
    … …  
    16901696 */
    16911697function get_the_author_url() {
    1692         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'url\')'  );
     1698        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'url\')' );
    16931699        return get_the_author_meta('url');
    16941700}
    … …  
    17031709 */
    17041710function the_author_url() {
    1705         _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'url\')'  );
     1711        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'url\')' );
    17061712        the_author_meta('url');
    17071713}
    … …  
    17181724 */
    17191725function get_the_author_ID() {
    1720         _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'ID\')'  );
     1726        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'ID\')' );
    17211727        return get_the_author_meta('ID');
    17221728}
    … …  
    17311737*/
    17321738function the_author_ID() {
    1733         _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'ID\')'  );
     1739        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'ID\')' );
    17341740        the_author_meta('ID');
    17351741}
    … …  
    17701776 */
    17711777function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file='', $cut = 0, $encode_html = 0) {
    1772         _deprecated_function( __FUNCTION__, '2.9', 'the_content_feed'  );
     1778        _deprecated_function( __FUNCTION__, '2.9', 'the_content_feed' );
    17731779        $content = get_the_content($more_link_text, $stripteaser, $more_file);
    17741780        $content = apply_filters('the_content_rss', $content);
    … …  
    18161822 */
    18171823function make_url_footnote( $content ) {
    1818         _deprecated_function( __FUNCTION__, '2.9', ''  );
     1824        _deprecated_function( __FUNCTION__, '2.9', '' );
    18191825        preg_match_all( '/<a(.+?)href=\"(.+?)\"(.*?)>(.+?)<\/a>/', $content, $matches );
    18201826        $links_summary = "\n";
    … …  
    18561862 */
    18571863function _c( $text, $domain = 'default' ) {
    1858         _deprecated_function(__FUNCTION__, '2.9', '_x' );
     1864        _deprecated_function( __FUNCTION__, '2.9', '_x()' );
    18591865        return translate_with_context( $text, $domain );
    18601866}
    … …  
    18731879 */
    18741880function _nc( $single, $plural, $number, $domain = 'default' ) {
    1875         _deprecated_function(__FUNCTION__, '2.9', '_nx' );
     1881        _deprecated_function( __FUNCTION__, '2.9', '_nx()' );
    18761882        return before_last_bar( _n( $single, $plural, $number, $domain ) );
    18771883}
    … …  
    18911897        return wp_load_alloptions();
    18921898}
     1899
     1900/**
     1901 * Retrieve HTML content of attachment image with link.
     1902 *
     1903 * @since 2.0.0
     1904 * @deprecated 2.5.0
     1905 * @deprecated Use wp_get_attachment_link()
     1906 * @see wp_get_attachment_link()
     1907 *
     1908 * @param int $id Optional. Post ID.
     1909 * @param bool $fullsize Optional, default is false. Whether to use full size image.
     1910 * @param array $max_dims Optional. Max image dimensions.
     1911 * @param bool $permalink Optional, default is false. Whether to include permalink to image.
     1912 * @return string
     1913 */
     1914function get_the_attachment_link($id = 0, $fullsize = false, $max_dims = false, $permalink = false) {
     1915        _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_link()' );
     1916        $id = (int) $id;
     1917        $_post = & get_post($id);
     1918
     1919        if ( ('attachment' != $_post->post_type) || !$url = wp_get_attachment_url($_post->ID) )
     1920                return __('Missing Attachment');
     1921
     1922        if ( $permalink )
     1923                $url = get_attachment_link($_post->ID);
     1924
     1925        $post_title = esc_attr($_post->post_title);
     1926
     1927        $innerHTML = get_attachment_innerHTML($_post->ID, $fullsize, $max_dims);
     1928        return "<a href='$url' title='$post_title'>$innerHTML</a>";
     1929}
     1930
     1931/**
     1932 * Retrieve icon URL and Path.
     1933 *
     1934 * @since 2.1.0
     1935 * @deprecated 2.5.0
     1936 * @deprecated Use wp_get_attachment_image_src()
     1937 * @see wp_get_attachment_image_src()
     1938 *
     1939 * @param int $id Optional. Post ID.
     1940 * @param bool $fullsize Optional, default to false. Whether to have full image.
     1941 * @return array Icon URL and full path to file, respectively.
     1942 */
     1943function get_attachment_icon_src( $id = 0, $fullsize = false ) {
     1944        _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_image_src()' );
     1945        $id = (int) $id;
     1946        if ( !$post = & get_post($id) )
     1947                return false;
     1948
     1949        $file = get_attached_file( $post->ID );
     1950
     1951        if ( !$fullsize && $src = wp_get_attachment_thumb_url( $post->ID ) ) {
     1952                // We have a thumbnail desired, specified and existing
     1953
     1954                $src_file = basename($src);
     1955                $class = 'attachmentthumb';
     1956        } elseif ( wp_attachment_is_image( $post->ID ) ) {
     1957                // We have an image without a thumbnail
     1958
     1959                $src = wp_get_attachment_url( $post->ID );
     1960                $src_file = & $file;
     1961                $class = 'attachmentimage';
     1962        } elseif ( $src = wp_mime_type_icon( $post->ID ) ) {
     1963                // No thumb, no image. We'll look for a mime-related icon instead.
     1964
     1965                $icon_dir = apply_filters( 'icon_dir', get_template_directory() . '/images' );
     1966                $src_file = $icon_dir . '/' . basename($src);
     1967        }
     1968
     1969        if ( !isset($src) || !$src )
     1970                return false;
     1971
     1972        return array($src, $src_file);
     1973}
     1974
     1975/**
     1976 * Retrieve HTML content of icon attachment image element.
     1977 *
     1978 * @since 2.0.0
     1979 * @deprecated 2.5.0
     1980 * @deprecated Use wp_get_attachment_image()
     1981 * @see wp_get_attachment_image()
     1982 *
     1983 * @param int $id Optional. Post ID.
     1984 * @param bool $fullsize Optional, default to false. Whether to have full size image.
     1985 * @param array $max_dims Optional. Dimensions of image.
     1986 * @return string HTML content.
     1987 */
     1988function get_attachment_icon( $id = 0, $fullsize = false, $max_dims = false ) {
     1989        _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_image()' );
     1990        $id = (int) $id;
     1991        if ( !$post = & get_post($id) )
     1992                return false;
     1993
     1994        if ( !$src = get_attachment_icon_src( $post->ID, $fullsize ) )
     1995                return false;
     1996
     1997        list($src, $src_file) = $src;
     1998
     1999        // Do we need to constrain the image?
     2000        if ( ($max_dims = apply_filters('attachment_max_dims', $max_dims)) && file_exists($src_file) ) {
     2001
     2002                $imagesize = getimagesize($src_file);
     2003
     2004                if (($imagesize[0] > $max_dims[0]) || $imagesize[1] > $max_dims[1] ) {
     2005                        $actual_aspect = $imagesize[0] / $imagesize[1];
     2006                        $desired_aspect = $max_dims[0] / $max_dims[1];
     2007
     2008                        if ( $actual_aspect >= $desired_aspect ) {
     2009                                $height = $actual_aspect * $max_dims[0];
     2010                                $constraint = "width='{$max_dims[0]}' ";
     2011                                $post->iconsize = array($max_dims[0], $height);
     2012                        } else {
     2013                                $width = $max_dims[1] / $actual_aspect;
     2014                                $constraint = "height='{$max_dims[1]}' ";
     2015                                $post->iconsize = array($width, $max_dims[1]);
     2016                        }
     2017                } else {
     2018                        $post->iconsize = array($imagesize[0], $imagesize[1]);
     2019                        $constraint = '';
     2020                }
     2021        } else {
     2022                $constraint = '';
     2023        }
     2024
     2025        $post_title = esc_attr($post->post_title);
     2026
     2027        $icon = "<img src='$src' title='$post_title' alt='$post_title' $constraint/>";
     2028
     2029        return apply_filters( 'attachment_icon', $icon, $post->ID );
     2030}
     2031
     2032/**
     2033 * Retrieve HTML content of image element.
     2034 *
     2035 * @since 2.0.0
     2036 * @deprecated 2.5.0
     2037 * @deprecated Use wp_get_attachment_image()
     2038 * @see wp_get_attachment_image()
     2039 *
     2040 * @param int $id Optional. Post ID.
     2041 * @param bool $fullsize Optional, default to false. Whether to have full size image.
     2042 * @param array $max_dims Optional. Dimensions of image.
     2043 * @return string
     2044 */
     2045function get_attachment_innerHTML($id = 0, $fullsize = false, $max_dims = false) {
     2046        _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_image()' );
     2047        $id = (int) $id;
     2048        if ( !$post = & get_post($id) )
     2049                return false;
     2050
     2051        if ( $innerHTML = get_attachment_icon($post->ID, $fullsize, $max_dims))
     2052                return $innerHTML;
     2053
     2054
     2055        $innerHTML = esc_attr($post->post_title);
     2056
     2057        return apply_filters('attachment_innerHTML', $innerHTML, $post->ID);
     2058}
     2059
     2060/*
     2061 * Retrieve bookmark data based on ID.
     2062 *
     2063 * @since 2.0.0
     2064 * @deprecated 2.1.0
     2065 * @deprecated Use get_bookmark()
     2066 * @see get_bookmark()
     2067 *
     2068 * @param int $bookmark_id ID of link
     2069 * @param string $output OBJECT, ARRAY_N, or ARRAY_A
     2070 * @return object|array
     2071 */
     2072function get_link($bookmark_id, $output = OBJECT, $filter = 'raw') {
     2073        _deprecated_function( __FUNCTION__, '2.1', 'get_bookmark()' );
     2074        return get_bookmark($bookmark_id, $output, $filter);
     2075}
     2076
    18932077?>

  • trunk/wp-includes/pluggable.php

    r13080 r13093  
    16371637if ( !function_exists('wp_setcookie') ) :
    16381638/**
    1639  * Sets a cookie for a user who just logged in.
     1639 * Sets a cookie for a user who just logged in. This function is deprecated.
    16401640 *
    16411641 * @since 1.5
     1642 * @deprecated 2.5
    16421643 * @deprecated Use wp_set_auth_cookie()
    16431644 * @see wp_set_auth_cookie()
    … …  
    16591660if ( !function_exists('wp_clearcookie') ) :
    16601661/**
    1661  * Clears the authentication cookie, logging the user out.
     1662 * Clears the authentication cookie, logging the user out. This function is deprecated.
    16621663 *
    16631664 * @since 1.5
     1665 * @deprecated 2.5
    16641666 * @deprecated Use wp_clear_auth_cookie()
    16651667 * @see wp_clear_auth_cookie()
    … …  
    16731675if ( !function_exists('wp_get_cookie_login') ):
    16741676/**
    1675  * Gets the user cookie login.
     1677 * Gets the user cookie login. This function is deprecated.
    16761678 *
    16771679 * This function is deprecated and should no longer be extended as it won't be
    … …  
    16791681 *
    16801682 * @since 2.0.3
     1683 * @deprecated 2.5
    16811684 * @deprecated No alternative
    16821685 *
    … …  
    16841687 */
    16851688function wp_get_cookie_login() {
    1686         _deprecated_function( __FUNCTION__, '2.5', '' );
     1689        _deprecated_function( __FUNCTION__, '2.5' );
    16871690        return false;
    16881691}
    … …  
    16911694if ( !function_exists('wp_login') ) :
    16921695/**
    1693  * Checks a users login information and logs them in if it checks out.
     1696 * Checks a users login information and logs them in if it checks out. This function is deprecated.
    16941697 *
    16951698 * Use the global $error to get the reason why the login failed. If the username
    … …  
    17101713 */
    17111714function wp_login($username, $password, $deprecated = '') {
     1715        _deprecated_function( __FUNCTION__, '2.5', 'wp_signon()' );
    17121716        global $error;
    17131717

  • trunk/wp-includes/post-template.php

    r13032 r13093  
    954954
    955955/**
    956  * Retrieve HTML content of attachment image with link.
    957  *
    958  * @since 2.0.0
    959  * @deprecated Use {@link wp_get_attachment_link()}
    960  * @see wp_get_attachment_link() Use instead.
    961  *
    962  * @param int $id Optional. Post ID.
    963  * @param bool $fullsize Optional, default is false. Whether to use full size image.
    964  * @param array $max_dims Optional. Max image dimensions.
    965  * @param bool $permalink Optional, default is false. Whether to include permalink to image.
    966  * @return string
    967  */
    968 function get_the_attachment_link($id = 0, $fullsize = false, $max_dims = false, $permalink = false) {
    969         $id = (int) $id;
    970         $_post = & get_post($id);
    971 
    972         if ( ('attachment' != $_post->post_type) || !$url = wp_get_attachment_url($_post->ID) )
    973                 return __('Missing Attachment');
    974 
    975         if ( $permalink )
    976                 $url = get_attachment_link($_post->ID);
    977 
    978         $post_title = esc_attr($_post->post_title);
    979 
    980         $innerHTML = get_attachment_innerHTML($_post->ID, $fullsize, $max_dims);
    981         return "<a href='$url' title='$post_title'>$innerHTML</a>";
    982 }
    983 
    984 /**
    985  * Retrieve icon URL and Path.
    986  *
    987  * @since 2.1.0
    988  * @deprecated Use {@link wp_get_attachment_image_src()}
    989  * @see wp_get_attachment_image_src() Use instead.
    990  *
    991  * @param int $id Optional. Post ID.
    992  * @param bool $fullsize Optional, default to false. Whether to have full image.
    993  * @return array Icon URL and full path to file, respectively.
    994  */
    995 function get_attachment_icon_src( $id = 0, $fullsize = false ) {
    996         $id = (int) $id;
    997         if ( !$post = & get_post($id) )
    998                 return false;
    999 
    1000         $file = get_attached_file( $post->ID );
    1001 
    1002         if ( !$fullsize && $src = wp_get_attachment_thumb_url( $post->ID ) ) {
    1003                 // We have a thumbnail desired, specified and existing
    1004 
    1005                 $src_file = basename($src);
    1006                 $class = 'attachmentthumb';
    1007         } elseif ( wp_attachment_is_image( $post->ID ) ) {
    1008                 // We have an image without a thumbnail
    1009 
    1010                 $src = wp_get_attachment_url( $post->ID );
    1011                 $src_file = & $file;
    1012                 $class = 'attachmentimage';
    1013         } elseif ( $src = wp_mime_type_icon( $post->ID ) ) {
    1014                 // No thumb, no image. We'll look for a mime-related icon instead.
    1015 
    1016                 $icon_dir = apply_filters( 'icon_dir', get_template_directory() . '/images' );
    1017                 $src_file = $icon_dir . '/' . basename($src);
    1018         }
    1019 
    1020         if ( !isset($src) || !$src )
    1021                 return false;
    1022 
    1023         return array($src, $src_file);
    1024 }
    1025 
    1026 /**
    1027  * Retrieve HTML content of icon attachment image element.
    1028  *
    1029  * @since 2.0.0
    1030  * @deprecated Use {@link wp_get_attachment_image()}
    1031  * @see wp_get_attachment_image() Use instead of.
    1032  *
    1033  * @param int $id Optional. Post ID.
    1034  * @param bool $fullsize Optional, default to false. Whether to have full size image.
    1035  * @param array $max_dims Optional. Dimensions of image.
    1036  * @return string HTML content.
    1037  */
    1038 function get_attachment_icon( $id = 0, $fullsize = false, $max_dims = false ) {
    1039         $id = (int) $id;
    1040         if ( !$post = & get_post($id) )
    1041                 return false;
    1042 
    1043         if ( !$src = get_attachment_icon_src( $post->ID, $fullsize ) )
    1044                 return false;
    1045 
    1046         list($src, $src_file) = $src;
    1047 
    1048         // Do we need to constrain the image?
    1049         if ( ($max_dims = apply_filters('attachment_max_dims', $max_dims)) && file_exists($src_file) ) {
    1050 
    1051                 $imagesize = getimagesize($src_file);
    1052 
    1053                 if (($imagesize[0] > $max_dims[0]) || $imagesize[1] > $max_dims[1] ) {
    1054                         $actual_aspect = $imagesize[0] / $imagesize[1];
    1055                         $desired_aspect = $max_dims[0] / $max_dims[1];
    1056 
    1057                         if ( $actual_aspect >= $desired_aspect ) {
    1058                                 $height = $actual_aspect * $max_dims[0];
    1059                                 $constraint = "width='{$max_dims[0]}' ";
    1060                                 $post->iconsize = array($max_dims[0], $height);
    1061                         } else {
    1062                                 $width = $max_dims[1] / $actual_aspect;
    1063                                 $constraint = "height='{$max_dims[1]}' ";
    1064                                 $post->iconsize = array($width, $max_dims[1]);
    1065                         }
    1066                 } else {
    1067                         $post->iconsize = array($imagesize[0], $imagesize[1]);
    1068                         $constraint = '';
    1069                 }
    1070         } else {
    1071                 $constraint = '';
    1072         }
    1073 
    1074         $post_title = esc_attr($post->post_title);
    1075 
    1076         $icon = "<img src='$src' title='$post_title' alt='$post_title' $constraint/>";
    1077 
    1078         return apply_filters( 'attachment_icon', $icon, $post->ID );
    1079 }
    1080 
    1081 /**
    1082  * Retrieve HTML content of image element.
    1083  *
    1084  * @since 2.0.0
    1085  * @deprecated Use {@link wp_get_attachment_image()}
    1086  * @see wp_get_attachment_image() Use instead.
    1087  *
    1088  * @param int $id Optional. Post ID.
    1089  * @param bool $fullsize Optional, default to false. Whether to have full size image.
    1090  * @param array $max_dims Optional. Dimensions of image.
    1091  * @return string
    1092  */
    1093 function get_attachment_innerHTML($id = 0, $fullsize = false, $max_dims = false) {
    1094         $id = (int) $id;
    1095         if ( !$post = & get_post($id) )
    1096                 return false;
    1097 
    1098         if ( $innerHTML = get_attachment_icon($post->ID, $fullsize, $max_dims))
    1099                 return $innerHTML;
    1100 
    1101 
    1102         $innerHTML = esc_attr($post->post_title);
    1103 
    1104         return apply_filters('attachment_innerHTML', $innerHTML, $post->ID);
    1105 }
    1106 
    1107 /**
    1108956 * Wrap attachment in <<p>> element before content.
    1109957 *
Note: See TracChangeset for help on using the changeset viewer.