WordPressを読む　63 /blog/wp-includes/shortcodes.php

2014/12/04 2015/02/28

1 /blog/wp-includes/shortcodes.php
2 関数　add_shortcode()
3 関数　remove_shortcode()
4 関数　remove_all_shortcodes()
5 関数　shortcode_exists()
6 関数　has_shortcode()
7 関数　do_shortcode()
8 関数　get_shortcode_regex()
9 関数　do_shortcode_tag()
10 関数　shortcode_parse_atts()
11 関数　shortcode_atts()
12 関数　strip_shortcodes()
13 関数　strip_shortcode_tag()

/blog/wp-includes/shortcodes.php

関数　add_shortcode()

<?php
/**
 * WordPress API for creating bbcode like tags or what WordPress calls
 * "shortcodes." The tag and attribute parsing or regular expression code is
 * based on the Textpattern tag parser.
 *
 * A few examples are below:
 *
 * [shortcode /]
 * [shortcode foo="bar" baz="bing" /]
 * [shortcode foo="bar"]content[/shortcode]
 *
 * Shortcode tags support attributes and enclosed content, but does not entirely
 * support inline shortcodes in other shortcodes. You will have to call the
 * shortcode parser in your function to account for that.
 *
 * {@internal
 * Please be aware that the above note was made during the beta of WordPress 2.6
 * and in the future may not be accurate. Please update the note when it is no
 * longer the case.}}
 *
 * To apply shortcode tags to content:
 *
 * <code>
 * $out = do_shortcode($content);
 * 
 *
 * @link http://codex.wordpress.org/Shortcode_API
 *
 * @package WordPress
 * @subpackage Shortcodes
 * @since 2.5.0
 */

/**
 * Container for storing shortcode tags and their hook to call for the shortcode
 *
 * @since 2.5.0
 *
 * @name $shortcode_tags
 * @var array
 * @global array $shortcode_tags
 */
$shortcode_tags = array();

/**
 * Add hook for shortcode tag.
 *
 * There can only be one hook for each shortcode. Which means that if another
 * plugin has a similar shortcode, it will override yours or yours will override
 * theirs depending on which order the plugins are included and/or ran.
 *
 * Simplest example of a shortcode tag using the API:
 *
 * <code>
 * // [footag foo="bar"]
 * function footag_func($atts) {
 * 	return "foo = {$atts[foo]}";
 * }
 * add_shortcode('footag', 'footag_func');
 * 
 *
 * Example with nice attribute defaults:
 *
 * <code>
 * // [bartag foo="bar"]
 * function bartag_func($atts) {
 * 	$args = shortcode_atts(array(
 * 		'foo' => 'no foo',
 * 		'baz' => 'default baz',
 * 	), $atts);
 *
 * 	return "foo = {$args['foo']}";
 * }
 * add_shortcode('bartag', 'bartag_func');
 * 
 *
 * Example with enclosed content:
 *
 * <code>
 * // [baztag]content[/baztag]
 * function baztag_func($atts, $content='') {
 * 	return "content = $content";
 * }
 * add_shortcode('baztag', 'baztag_func');
 * 
 *
 * @since 2.5.0
 *
 * @uses $shortcode_tags
 *
 * @param string $tag Shortcode tag to be searched in post content.
 * @param callable $func Hook to run when shortcode is found.
 */
function add_shortcode($tag, $func) {
	global $shortcode_tags;

	if ( is_callable($func) )
		$shortcode_tags[$tag] = $func;
}

100

<?php

/**

* WordPress API for creating bbcode like tags or what WordPress calls

* "shortcodes." The tag and attribute parsing or regular expression code is

* based on the Textpattern tag parser.

* A few examples are below:

* [shortcode /]

* [shortcode foo="bar" baz="bing" /]

* [shortcode foo="bar"]content[/shortcode]

* Shortcode tags support attributes and enclosed content, but does not entirely

* support inline shortcodes in other shortcodes. You will have to call the

* shortcode parser in your function to account for that.

* {@internal

* Please be aware that the above note was made during the beta of WordPress 2.6

* and in the future may not be accurate. Please update the note when it is no

* longer the case.}}

* To apply shortcode tags to content:

* <code>

* $out = do_shortcode($content);

* @link http://codex.wordpress.org/Shortcode_API

* @package WordPress

* @subpackage Shortcodes

* @since 2.5.0

/**

* Container for storing shortcode tags and their hook to call for the shortcode

* @since 2.5.0

* @name $shortcode_tags

* @var array

* @global array $shortcode_tags

$shortcode_tags = array();

/**

* Add hook for shortcode tag.

* There can only be one hook for each shortcode. Which means that if another

* plugin has a similar shortcode, it will override yours or yours will override

* theirs depending on which order the plugins are included and/or ran.

* Simplest example of a shortcode tag using the API:

* <code>

* // [footag foo="bar"]

* function footag_func($atts) {

* return "foo = {$atts[foo]}";

* }

* add_shortcode('footag', 'footag_func');

* Example with nice attribute defaults:

* <code>

* // [bartag foo="bar"]

* function bartag_func($atts) {

* $args = shortcode_atts(array(

* 'foo' => 'no foo',

* 'baz' => 'default baz',

* ), $atts);

* return "foo = {$args['foo']}";

* }

* add_shortcode('bartag', 'bartag_func');

* Example with enclosed content:

* <code>

* // [baztag]content[/baztag]

* function baztag_func($atts, $content='') {

* return "content = $content";

* }

* add_shortcode('baztag', 'baztag_func');

* @since 2.5.0

* @uses $shortcode_tags

* @param string $tag Shortcode tag to be searched in post content.

* @param callable $func Hook to run when shortcode is found.

function add_shortcode($tag, $func) {

global $shortcode_tags;

if ( is_callable($func) )

$shortcode_tags[$tag] = $func;

}

関数　remove_shortcode()

/**
 * Removes hook for shortcode.
 *
 * @since 2.5.0
 *
 * @uses $shortcode_tags
 *
 * @param string $tag shortcode tag to remove hook for.
 */
function remove_shortcode($tag) {
	global $shortcode_tags;

	unset($shortcode_tags[$tag]);
}

/**

* Removes hook for shortcode.

* @since 2.5.0

* @uses $shortcode_tags

* @param string $tag shortcode tag to remove hook for.

function remove_shortcode($tag) {

global $shortcode_tags;

unset($shortcode_tags[$tag]);

}

関数　remove_all_shortcodes()

/**
 * Clear all shortcodes.
 *
 * This function is simple, it clears all of the shortcode tags by replacing the
 * shortcodes global by a empty array. This is actually a very efficient method
 * for removing all shortcodes.
 *
 * @since 2.5.0
 *
 * @uses $shortcode_tags
 */
function remove_all_shortcodes() {
	global $shortcode_tags;

	$shortcode_tags = array();
}

/**

* Clear all shortcodes.

* This function is simple, it clears all of the shortcode tags by replacing the

* shortcodes global by a empty array. This is actually a very efficient method

* for removing all shortcodes.

* @since 2.5.0

* @uses $shortcode_tags

function remove_all_shortcodes() {

global $shortcode_tags;

$shortcode_tags = array();

}

関数　shortcode_exists()

/**
 * Whether a registered shortcode exists named $tag
 *
 * @since 3.6.0
 *
 * @global array $shortcode_tags
 * @param string $tag
 * @return boolean
 */
function shortcode_exists( $tag ) {
	global $shortcode_tags;
	return array_key_exists( $tag, $shortcode_tags );
}

/**

* Whether a registered shortcode exists named $tag

* @since 3.6.0

* @global array $shortcode_tags

* @param string $tag

* @return boolean

function shortcode_exists( $tag ) {

global $shortcode_tags;

return array_key_exists( $tag, $shortcode_tags );

}

関数　has_shortcode()

/**
 * Whether the passed content contains the specified shortcode
 *
 * @since 3.6.0
 *
 * @global array $shortcode_tags
 * @param string $tag
 * @return boolean
 */
function has_shortcode( $content, $tag ) {
	if ( false === strpos( $content, '[' ) ) {
		return false;
	}

	if ( shortcode_exists( $tag ) ) {
		preg_match_all( '/' . get_shortcode_regex() . '/s', $content, $matches, PREG_SET_ORDER );
		if ( empty( $matches ) )
			return false;

		foreach ( $matches as $shortcode ) {
			if ( $tag === $shortcode[2] ) {
				return true;
			} elseif ( ! empty( $shortcode[5] ) && has_shortcode( $shortcode[5], $tag ) ) {
				return true;
			}
		}
	}
	return false;
}

/**

* Whether the passed content contains the specified shortcode

* @since 3.6.0

* @global array $shortcode_tags

* @param string $tag

* @return boolean

function has_shortcode( $content, $tag ) {

if ( false === strpos( $content, '[' ) ) {

return false;

}

if ( shortcode_exists( $tag ) ) {

preg_match_all( '/' . get_shortcode_regex() . '/s', $content, $matches, PREG_SET_ORDER );

if ( empty( $matches ) )

return false;

foreach ( $matches as $shortcode ) {

if ( $tag === $shortcode[2] ) {

return true;

} elseif ( ! empty( $shortcode[5] ) && has_shortcode( $shortcode[5], $tag ) ) {

return true;

}

return false;

}

関数　do_shortcode()

/**
 * Search content for shortcodes and filter shortcodes through their hooks.
 *
 * If there are no shortcode tags defined, then the content will be returned
 * without any filtering. This might cause issues when plugins are disabled but
 * the shortcode will still show up in the post or content.
 *
 * @since 2.5.0
 *
 * @uses $shortcode_tags
 * @uses get_shortcode_regex() Gets the search pattern for searching shortcodes.
 *
 * @param string $content Content to search for shortcodes
 * @return string Content with shortcodes filtered out.
 */
function do_shortcode($content) {
	global $shortcode_tags;

	if ( false === strpos( $content, '[' ) ) {
		return $content;
	}

	if (empty($shortcode_tags) || !is_array($shortcode_tags))
		return $content;

	$pattern = get_shortcode_regex();
	return preg_replace_callback( "/$pattern/s", 'do_shortcode_tag', $content );
}

/**

* Search content for shortcodes and filter shortcodes through their hooks.

* If there are no shortcode tags defined, then the content will be returned

* without any filtering. This might cause issues when plugins are disabled but

* the shortcode will still show up in the post or content.

* @since 2.5.0

* @uses $shortcode_tags

* @uses get_shortcode_regex() Gets the search pattern for searching shortcodes.

* @param string $content Content to search for shortcodes

* @return string Content with shortcodes filtered out.

function do_shortcode($content) {

global $shortcode_tags;

if ( false === strpos( $content, '[' ) ) {

return $content;

}

if (empty($shortcode_tags) || !is_array($shortcode_tags))

return $content;

$pattern = get_shortcode_regex();

return preg_replace_callback( "/$pattern/s", 'do_shortcode_tag', $content );

}

関数　get_shortcode_regex()

/**
 * Retrieve the shortcode regular expression for searching.
 *
 * The regular expression combines the shortcode tags in the regular expression
 * in a regex class.
 *
 * The regular expression contains 6 different sub matches to help with parsing.
 *
 * 1 - An extra [ to allow for escaping shortcodes with double [[]]
 * 2 - The shortcode name
 * 3 - The shortcode argument list
 * 4 - The self closing /
 * 5 - The content of a shortcode when it wraps some content.
 * 6 - An extra ] to allow for escaping shortcodes with double [[]]
 *
 * @since 2.5.0
 *
 * @uses $shortcode_tags
 *
 * @return string The shortcode search regular expression
 */
function get_shortcode_regex() {
	global $shortcode_tags;
	$tagnames = array_keys($shortcode_tags);
	$tagregexp = join( '|', array_map('preg_quote', $tagnames) );

	// WARNING! Do not change this regex without changing do_shortcode_tag() and strip_shortcode_tag()
	// Also, see shortcode_unautop() and shortcode.js.
	return
		  '\\['                              // Opening bracket
		. '(\\[?)'                           // 1: Optional second opening bracket for escaping shortcodes: [[tag]]
		. "($tagregexp)"                     // 2: Shortcode name
		. '(?![\\w-])'                       // Not followed by word character or hyphen
		. '('                                // 3: Unroll the loop: Inside the opening shortcode tag
		.     '[^\\]\\/]*'                   // Not a closing bracket or forward slash
		.     '(?:'
		.         '\\/(?!\\])'               // A forward slash not followed by a closing bracket
		.         '[^\\]\\/]*'               // Not a closing bracket or forward slash
		.     ')*?'
		. ')'
		. '(?:'
		.     '(\\/)'                        // 4: Self closing tag ...
		.     '\\]'                          // ... and closing bracket
		. '|'
		.     '\\]'                          // Closing bracket
		.     '(?:'
		.         '('                        // 5: Unroll the loop: Optionally, anything between the opening and closing shortcode tags
		.             '[^\\[]*+'             // Not an opening bracket
		.             '(?:'
		.                 '\\[(?!\\/\\2\\])' // An opening bracket not followed by the closing shortcode tag
		.                 '[^\\[]*+'         // Not an opening bracket
		.             ')*+'
		.         ')'
		.         '\\[\\/\\2\\]'             // Closing shortcode tag
		.     ')?'
		. ')'
		. '(\\]?)';                          // 6: Optional second closing brocket for escaping shortcodes: [[tag]]
}

/**

* Retrieve the shortcode regular expression for searching.

* The regular expression combines the shortcode tags in the regular expression

* in a regex class.

* The regular expression contains 6 different sub matches to help with parsing.

* 1 - An extra [ to allow for escaping shortcodes with double [[]]

* 2 - The shortcode name

* 3 - The shortcode argument list

* 4 - The self closing /

* 5 - The content of a shortcode when it wraps some content.

* 6 - An extra ] to allow for escaping shortcodes with double [[]]

* @since 2.5.0

* @uses $shortcode_tags

* @return string The shortcode search regular expression

function get_shortcode_regex() {

global $shortcode_tags;

$tagnames = array_keys($shortcode_tags);

$tagregexp = join( '|', array_map('preg_quote', $tagnames) );

// WARNING! Do not change this regex without changing do_shortcode_tag() and strip_shortcode_tag()

// Also, see shortcode_unautop() and shortcode.js.

return

'\\[' // Opening bracket

. '(\\[?)' // 1: Optional second opening bracket for escaping shortcodes: [[tag]]

. "($tagregexp)" // 2: Shortcode name

. '(?![\\w-])' // Not followed by word character or hyphen

. '(' // 3: Unroll the loop: Inside the opening shortcode tag

. '[^\\]\\/]*' // Not a closing bracket or forward slash

. '(?:'

. '\\/(?!\\])' // A forward slash not followed by a closing bracket

. '[^\\]\\/]*' // Not a closing bracket or forward slash

. ')*?'

. ')'

. '(?:'

. '(\\/)' // 4: Self closing tag ...

. '\\]' // ... and closing bracket

. '|'

. '\\]' // Closing bracket

. '(?:'

. '(' // 5: Unroll the loop: Optionally, anything between the opening and closing shortcode tags

. '[^\\[]*+' // Not an opening bracket

. '(?:'

. '\\[(?!\\/\\2\\])' // An opening bracket not followed by the closing shortcode tag

. '[^\\[]*+' // Not an opening bracket

. ')*+'

. ')'

. '\\[\\/\\2\\]' // Closing shortcode tag

. ')?'

. ')'

. '(\\]?)'; // 6: Optional second closing brocket for escaping shortcodes: [[tag]]

}

関数　do_shortcode_tag()

/**
 * Regular Expression callable for do_shortcode() for calling shortcode hook.
 * @see get_shortcode_regex for details of the match array contents.
 *
 * @since 2.5.0
 * @access private
 * @uses $shortcode_tags
 *
 * @param array $m Regular expression match array
 * @return mixed False on failure.
 */
function do_shortcode_tag( $m ) {
	global $shortcode_tags;

	// allow [[foo]] syntax for escaping a tag
	if ( $m[1] == '[' && $m[6] == ']' ) {
		return substr($m[0], 1, -1);
	}

	$tag = $m[2];
	$attr = shortcode_parse_atts( $m[3] );

	if ( isset( $m[5] ) ) {
		// enclosing tag - extra parameter
		return $m[1] . call_user_func( $shortcode_tags[$tag], $attr, $m[5], $tag ) . $m[6];
	} else {
		// self-closing tag
		return $m[1] . call_user_func( $shortcode_tags[$tag], $attr, null,  $tag ) . $m[6];
	}
}

/**

* Regular Expression callable for do_shortcode() for calling shortcode hook.

* @see get_shortcode_regex for details of the match array contents.

* @since 2.5.0

* @access private

* @uses $shortcode_tags

* @param array $m Regular expression match array

* @return mixed False on failure.

function do_shortcode_tag( $m ) {

global $shortcode_tags;

// allow [[foo]] syntax for escaping a tag

if ( $m[1] == '[' && $m[6] == ']' ) {

return substr($m[0], 1, -1);

}

$tag = $m[2];

$attr = shortcode_parse_atts( $m[3] );

if ( isset( $m[5] ) ) {

// enclosing tag - extra parameter

return $m[1] . call_user_func( $shortcode_tags[$tag], $attr, $m[5], $tag ) . $m[6];

} else {

// self-closing tag

return $m[1] . call_user_func( $shortcode_tags[$tag], $attr, null, $tag ) . $m[6];

}

関数　shortcode_parse_atts()

/**
 * Retrieve all attributes from the shortcodes tag.
 *
 * The attributes list has the attribute name as the key and the value of the
 * attribute as the value in the key/value pair. This allows for easier
 * retrieval of the attributes, since all attributes have to be known.
 *
 * @since 2.5.0
 *
 * @param string $text
 * @return array List of attributes and their value.
 */
function shortcode_parse_atts($text) {
	$atts = array();
	$pattern = '/(\w+)\s*=\s*"([^"]*)"(?:\s|$)|(\w+)\s*=\s*\'([^\']*)\'(?:\s|$)|(\w+)\s*=\s*([^\s\'"]+)(?:\s|$)|"([^"]*)"(?:\s|$)|(\S+)(?:\s|$)/';
	$text = preg_replace("/[\x{00a0}\x{200b}]+/u", " ", $text);
	if ( preg_match_all($pattern, $text, $match, PREG_SET_ORDER) ) {
		foreach ($match as $m) {
			if (!empty($m[1]))
				$atts[strtolower($m[1])] = stripcslashes($m[2]);
			elseif (!empty($m[3]))
				$atts[strtolower($m[3])] = stripcslashes($m[4]);
			elseif (!empty($m[5]))
				$atts[strtolower($m[5])] = stripcslashes($m[6]);
			elseif (isset($m[7]) and strlen($m[7]))
				$atts[] = stripcslashes($m[7]);
			elseif (isset($m[8]))
				$atts[] = stripcslashes($m[8]);
		}
	} else {
		$atts = ltrim($text);
	}
	return $atts;
}

/**

* Retrieve all attributes from the shortcodes tag.

* The attributes list has the attribute name as the key and the value of the

* attribute as the value in the key/value pair. This allows for easier

* retrieval of the attributes, since all attributes have to be known.

* @since 2.5.0

* @param string $text

* @return array List of attributes and their value.

function shortcode_parse_atts($text) {

$atts = array();

$pattern = '/(\w+)\s*=\s*"([^"]*)"(?:\s|$)|(\w+)\s*=\s*\'([^\']*)\'(?:\s|$)|(\w+)\s*=\s*([^\s\'"]+)(?:\s|$)|"([^"]*)"(?:\s|$)|(\S+)(?:\s|$)/';

$text = preg_replace("/[\x{00a0}\x{200b}]+/u", " ", $text);

if ( preg_match_all($pattern, $text, $match, PREG_SET_ORDER) ) {

foreach ($match as $m) {

if (!empty($m[1]))

$atts[strtolower($m[1])] = stripcslashes($m[2]);

elseif (!empty($m[3]))

$atts[strtolower($m[3])] = stripcslashes($m[4]);

elseif (!empty($m[5]))

$atts[strtolower($m[5])] = stripcslashes($m[6]);

elseif (isset($m[7]) and strlen($m[7]))

$atts[] = stripcslashes($m[7]);

elseif (isset($m[8]))

$atts[] = stripcslashes($m[8]);

}

} else {

$atts = ltrim($text);

}

return $atts;

}

関数　shortcode_atts()

/**
 * Combine user attributes with known attributes and fill in defaults when needed.
 *
 * The pairs should be considered to be all of the attributes which are
 * supported by the caller and given as a list. The returned attributes will
 * only contain the attributes in the $pairs list.
 *
 * If the $atts list has unsupported attributes, then they will be ignored and
 * removed from the final returned list.
 *
 * @since 2.5.0
 *
 * @param array $pairs Entire list of supported attributes and their defaults.
 * @param array $atts User defined attributes in shortcode tag.
 * @param string $shortcode Optional. The name of the shortcode, provided for context to enable filtering
 * @return array Combined and filtered attribute list.
 */
function shortcode_atts( $pairs, $atts, $shortcode = '' ) {
	$atts = (array)$atts;
	$out = array();
	foreach($pairs as $name => $default) {
		if ( array_key_exists($name, $atts) )
			$out[$name] = $atts[$name];
		else
			$out[$name] = $default;
	}
	/**
	 * Filter a shortcode's default attributes.
	 *
	 * If the third parameter of the shortcode_atts() function is present then this filter is available.
	 * The third parameter, $shortcode, is the name of the shortcode.
	 *
	 * @since 3.6.0
	 *
	 * @param array $out The output array of shortcode attributes.
	 * @param array $pairs The supported attributes and their defaults.
	 * @param array $atts The user defined shortcode attributes.
	 */
	if ( $shortcode )
		$out = apply_filters( "shortcode_atts_{$shortcode}", $out, $pairs, $atts );

	return $out;
}

/**

* Combine user attributes with known attributes and fill in defaults when needed.

* The pairs should be considered to be all of the attributes which are

* supported by the caller and given as a list. The returned attributes will

* only contain the attributes in the $pairs list.

* If the $atts list has unsupported attributes, then they will be ignored and

* removed from the final returned list.

* @since 2.5.0

* @param array $pairs Entire list of supported attributes and their defaults.

* @param array $atts User defined attributes in shortcode tag.

* @param string $shortcode Optional. The name of the shortcode, provided for context to enable filtering

* @return array Combined and filtered attribute list.

function shortcode_atts( $pairs, $atts, $shortcode = '' ) {

$atts = (array)$atts;

$out = array();

foreach($pairs as $name => $default) {

if ( array_key_exists($name, $atts) )

$out[$name] = $atts[$name];

else

$out[$name] = $default;

}

/**

* Filter a shortcode's default attributes.

* If the third parameter of the shortcode_atts() function is present then this filter is available.

* The third parameter, $shortcode, is the name of the shortcode.

* @since 3.6.0

* @param array $out The output array of shortcode attributes.

* @param array $pairs The supported attributes and their defaults.

* @param array $atts The user defined shortcode attributes.

if ( $shortcode )

$out = apply_filters( "shortcode_atts_{$shortcode}", $out, $pairs, $atts );

return $out;

}

関数　strip_shortcodes()

/**
 * Remove all shortcode tags from the given content.
 *
 * @since 2.5.0
 *
 * @uses $shortcode_tags
 *
 * @param string $content Content to remove shortcode tags.
 * @return string Content without shortcode tags.
 */
function strip_shortcodes( $content ) {
	global $shortcode_tags;

	if ( false === strpos( $content, '[' ) ) {
		return $content;
	}

	if (empty($shortcode_tags) || !is_array($shortcode_tags))
		return $content;

	$pattern = get_shortcode_regex();

	return preg_replace_callback( "/$pattern/s", 'strip_shortcode_tag', $content );
}

/**

* Remove all shortcode tags from the given content.

* @since 2.5.0

* @uses $shortcode_tags

* @param string $content Content to remove shortcode tags.

* @return string Content without shortcode tags.

function strip_shortcodes( $content ) {

global $shortcode_tags;

if ( false === strpos( $content, '[' ) ) {

return $content;

}

if (empty($shortcode_tags) || !is_array($shortcode_tags))

return $content;

$pattern = get_shortcode_regex();

return preg_replace_callback( "/$pattern/s", 'strip_shortcode_tag', $content );

}

関数　strip_shortcode_tag()

function strip_shortcode_tag( $m ) {
	// allow [[foo]] syntax for escaping a tag
	if ( $m[1] == '[' && $m[6] == ']' ) {
		return substr($m[0], 1, -1);
	}

	return $m[1] . $m[6];
}

add_filter('the_content', 'do_shortcode', 11); // AFTER wpautop()

function strip_shortcode_tag( $m ) {

// allow [[foo]] syntax for escaping a tag

if ( $m[1] == '[' && $m[6] == ']' ) {

return substr($m[0], 1, -1);

}

return $m[1] . $m[6];

}

add_filter('the_content', 'do_shortcode', 11); // AFTER wpautop()

- Wordpress

: WordPressを読む　74 /blog/wp-content/plugins/akismet/class.akismet.php
/blog/wp-content/plugins/akismet/class.a …

: WordPressを読む　30 /blog/wp-includes/class-wp-theme.php
目次1 /blog/wp-includes/class-wp-theme.php …

: WordPressを読む　60-6 /blog/wp-includes/taxonomy.php 6
/blog/wp-includes/taxonomy.php 6 [crayon …

: WordPressを読む　10-18　/blog/wp-includes/functions.php 18
目次1 /blog/wp-includes/functions.php 182 …

WordPressを読む　72 /blog/wp-includes/vars.php

<?php
/**
 * Creates common globals for the rest of WordPress
 *
 * Sets $pagenow global which is the current page. Checks
 * for the browser to set which one is currently being used.
 *
 * Detects which user environment WordPress is being used on.
 * Only attempts to check for Apache, Nginx and IIS -- three web
 * servers with known pretty permalink capability.
 *
 * Note: Though Nginx is detected, WordPress does not currently
 * generate rewrite rules for it. See http://codex.wordpress.org/Nginx
 *
 * @package WordPress
 */

global $pagenow,
	$is_lynx, $is_gecko, $is_winIE, $is_macIE, $is_opera, $is_NS4, $is_safari, $is_chrome, $is_iphone, $is_IE,
	$is_apache, $is_IIS, $is_iis7, $is_nginx;

// On which page are we ?
if ( is_admin() ) {
	// wp-admin pages are checked more carefully
	if ( is_network_admin() )
		preg_match('#/wp-admin/network/?(.*?)$#i', $_SERVER['PHP_SELF'], $self_matches);
	elseif ( is_user_admin() )
		preg_match('#/wp-admin/user/?(.*?)$#i', $_SERVER['PHP_SELF'], $self_matches);
	else
		preg_match('#/wp-admin/?(.*?)$#i', $_SERVER['PHP_SELF'], $self_matches);
	$pagenow = $self_matches[1];
	$pagenow = trim($pagenow, '/');
	$pagenow = preg_replace('#\?.*?$#', '', $pagenow);
	if ( '' === $pagenow || 'index' === $pagenow || 'index.php' === $pagenow ) {
		$pagenow = 'index.php';
	} else {
		preg_match('#(.*?)(/|$)#', $pagenow, $self_matches);
		$pagenow = strtolower($self_matches[1]);
		if ( '.php' !== substr($pagenow, -4, 4) )
			$pagenow .= '.php'; // for Options +Multiviews: /wp-admin/themes/index.php (themes.php is queried)
	}
} else {
	if ( preg_match('#([^/]+\.php)([?/].*?)?$#i', $_SERVER['PHP_SELF'], $self_matches) )
		$pagenow = strtolower($self_matches[1]);
	else
		$pagenow = 'index.php';
}
unset($self_matches);

// Simple browser detection
$is_lynx = $is_gecko = $is_winIE = $is_macIE = $is_opera = $is_NS4 = $is_safari = $is_chrome = $is_iphone = false;

if ( isset($_SERVER['HTTP_USER_AGENT']) ) {
	if ( strpos($_SERVER['HTTP_USER_AGENT'], 'Lynx') !== false ) {
		$is_lynx = true;
	} elseif ( stripos($_SERVER['HTTP_USER_AGENT'], 'chrome') !== false ) {
		if ( stripos( $_SERVER['HTTP_USER_AGENT'], 'chromeframe' ) !== false ) {
			$is_admin = is_admin();
			/**
			 * Filter whether Google Chrome Frame should be used, if available.
			 *
			 * @since 3.2.0
			 *
			 * @param bool $is_admin Whether to use the Google Chrome Frame. Default is the value of is_admin().
			 */
			if ( $is_chrome = apply_filters( 'use_google_chrome_frame', $is_admin ) )
				header( 'X-UA-Compatible: chrome=1' );
			$is_winIE = ! $is_chrome;
		} else {
			$is_chrome = true;
		}
	} elseif ( stripos($_SERVER['HTTP_USER_AGENT'], 'safari') !== false ) {
		$is_safari = true;
	} elseif ( ( strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE') !== false || strpos($_SERVER['HTTP_USER_AGENT'], 'Trident') !== false ) && strpos($_SERVER['HTTP_USER_AGENT'], 'Win') !== false ) {
		$is_winIE = true;
	} elseif ( strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE') !== false && strpos($_SERVER['HTTP_USER_AGENT'], 'Mac') !== false ) {
		$is_macIE = true;
	} elseif ( strpos($_SERVER['HTTP_USER_AGENT'], 'Gecko') !== false ) {
		$is_gecko = true;
	} elseif ( strpos($_SERVER['HTTP_USER_AGENT'], 'Opera') !== false ) {
		$is_opera = true;
	} elseif ( strpos($_SERVER['HTTP_USER_AGENT'], 'Nav') !== false && strpos($_SERVER['HTTP_USER_AGENT'], 'Mozilla/4.') !== false ) {
		$is_NS4 = true;
	}
}

if ( $is_safari && stripos($_SERVER['HTTP_USER_AGENT'], 'mobile') !== false )
	$is_iphone = true;

$is_IE = ( $is_macIE || $is_winIE );

// Server detection

/**
 * Whether the server software is Apache or something else
 * @global bool $is_apache
 */
$is_apache = (strpos($_SERVER['SERVER_SOFTWARE'], 'Apache') !== false || strpos($_SERVER['SERVER_SOFTWARE'], 'LiteSpeed') !== false);

/**
 * Whether the server software is Nginx or something else
 * @global bool $is_nginx
 */
$is_nginx = (strpos($_SERVER['SERVER_SOFTWARE'], 'nginx') !== false);

/**
 * Whether the server software is IIS or something else
 * @global bool $is_IIS
 */
$is_IIS = !$is_apache && (strpos($_SERVER['SERVER_SOFTWARE'], 'Microsoft-IIS') !== false || strpos($_SERVER['SERVER_SOFTWARE'], 'ExpressionDevServer') !== false);

/**
 * Whether the server software is IIS 7.X or greater
 * @global bool $is_iis7
 */
$is_iis7 = $is_IIS && intval( substr( $_SERVER['SERVER_SOFTWARE'], strpos( $_SERVER['SERVER_SOFTWARE'], 'Microsoft-IIS/' ) + 14 ) ) >= 7;

/**
 * Test if the current browser runs on a mobile device (smart phone, tablet, etc.)
 *
 * @return bool true|false
 */
function wp_is_mobile() {
	static $is_mobile;

	if ( isset($is_mobile) )
		return $is_mobile;

	if ( empty($_SERVER['HTTP_USER_AGENT']) ) {
		$is_mobile = false;
	} elseif ( strpos($_SERVER['HTTP_USER_AGENT'], 'Mobile') !== false // many mobile devices (all iPhone, iPad, etc.)
		|| strpos($_SERVER['HTTP_USER_AGENT'], 'Android') !== false
		|| strpos($_SERVER['HTTP_USER_AGENT'], 'Silk/') !== false
		|| strpos($_SERVER['HTTP_USER_AGENT'], 'Kindle') !== false
		|| strpos($_SERVER['HTTP_USER_AGENT'], 'BlackBerry') !== false
		|| strpos($_SERVER['HTTP_USER_AGENT'], 'Opera Mini') !== false
		|| strpos($_SERVER['HTTP_USER_AGENT'], 'Opera Mobi') !== false ) {
			$is_mobile = true;
	} else {
		$is_mobile = false;
	}

	return $is_mobile;
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

<?php

/**

* Creates common globals for the rest of WordPress

* Sets $pagenow global which is the current page. Checks

* for the browser to set which one is currently being used.

* Detects which user environment WordPress is being used on.

* Only attempts to check for Apache, Nginx and IIS -- three web

* servers with known pretty permalink capability.

* Note: Though Nginx is detected, WordPress does not currently

* generate rewrite rules for it. See http://codex.wordpress.org/Nginx

* @package WordPress

global $pagenow,

$is_lynx, $is_gecko, $is_winIE, $is_macIE, $is_opera, $is_NS4, $is_safari, $is_chrome, $is_iphone, $is_IE,

$is_apache, $is_IIS, $is_iis7, $is_nginx;

// On which page are we ?

if ( is_admin() ) {

// wp-admin pages are checked more carefully

if ( is_network_admin() )

preg_match('#/wp-admin/network/?(.*?)$#i', $_SERVER['PHP_SELF'], $self_matches);

elseif ( is_user_admin() )

preg_match('#/wp-admin/user/?(.*?)$#i', $_SERVER['PHP_SELF'], $self_matches);

else

preg_match('#/wp-admin/?(.*?)$#i', $_SERVER['PHP_SELF'], $self_matches);

$pagenow = $self_matches[1];

$pagenow = trim($pagenow, '/');

$pagenow = preg_replace('#\?.*?$#', '', $pagenow);

if ( '' === $pagenow || 'index' === $pagenow || 'index.php' === $pagenow ) {

$pagenow = 'index.php';

} else {

preg_match('#(.*?)(/|$)#', $pagenow, $self_matches);

$pagenow = strtolower($self_matches[1]);

if ( '.php' !== substr($pagenow, -4, 4) )

$pagenow .= '.php'; // for Options +Multiviews: /wp-admin/themes/index.php (themes.php is queried)

}

} else {

if ( preg_match('#([^/]+\.php)([?/].*?)?$#i', $_SERVER['PHP_SELF'], $self_matches) )

$pagenow = strtolower($self_matches[1]);

else

$pagenow = 'index.php';

}

unset($self_matches);

// Simple browser detection

$is_lynx = $is_gecko = $is_winIE = $is_macIE = $is_opera = $is_NS4 = $is_safari = $is_chrome = $is_iphone = false;

if ( isset($_SERVER['HTTP_USER_AGENT']) ) {

if ( strpos($_SERVER['HTTP_USER_AGENT'], 'Lynx') !== false ) {

$is_lynx = true;

} elseif ( stripos($_SERVER['HTTP_USER_AGENT'], 'chrome') !== false ) {

if ( stripos( $_SERVER['HTTP_USER_AGENT'], 'chromeframe' ) !== false ) {

$is_admin = is_admin();

/**

* Filter whether Google Chrome Frame should be used, if available.

* @since 3.2.0

* @param bool $is_admin Whether to use the Google Chrome Frame. Default is the value of is_admin().

if ( $is_chrome = apply_filters( 'use_google_chrome_frame', $is_admin ) )

header( 'X-UA-Compatible: chrome=1' );

$is_winIE = ! $is_chrome;

} else {

$is_chrome = true;

}

} elseif ( stripos($_SERVER['HTTP_USER_AGENT'], 'safari') !== false ) {

$is_safari = true;

} elseif ( ( strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE') !== false || strpos($_SERVER['HTTP_USER_AGENT'], 'Trident') !== false ) && strpos($_SERVER['HTTP_USER_AGENT'], 'Win') !== false ) {

$is_winIE = true;

} elseif ( strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE') !== false && strpos($_SERVER['HTTP_USER_AGENT'], 'Mac') !== false ) {

$is_macIE = true;

} elseif ( strpos($_SERVER['HTTP_USER_AGENT'], 'Gecko') !== false ) {

$is_gecko = true;

} elseif ( strpos($_SERVER['HTTP_USER_AGENT'], 'Opera') !== false ) {

$is_opera = true;

} elseif ( strpos($_SERVER['HTTP_USER_AGENT'], 'Nav') !== false && strpos($_SERVER['HTTP_USER_AGENT'], 'Mozilla/4.') !== false ) {

$is_NS4 = true;

}

if ( $is_safari && stripos($_SERVER['HTTP_USER_AGENT'], 'mobile') !== false )

$is_iphone = true;

$is_IE = ( $is_macIE || $is_winIE );

// Server detection

/**

* Whether the server software is Apache or something else

* @global bool $is_apache

$is_apache = (strpos($_SERVER['SERVER_SOFTWARE'], 'Apache') !== false || strpos($_SERVER['SERVER_SOFTWARE'], 'LiteSpeed') !== false);

/**

* Whether the server software is Nginx or something else

* @global bool $is_nginx

$is_nginx = (strpos($_SERVER['SERVER_SOFTWARE'], 'nginx') !== false);

/**

* Whether the server software is IIS or something else

* @global bool $is_IIS

$is_IIS = !$is_apache && (strpos($_SERVER['SERVER_SOFTWARE'], 'Microsoft-IIS') !== false || strpos($_SERVER['SERVER_SOFTWARE'], 'ExpressionDevServer') !== false);

/**

* Whether the server software is IIS 7.X or greater

* @global bool $is_iis7

$is_iis7 = $is_IIS && intval( substr( $_SERVER['SERVER_SOFTWARE'], strpos( $_SERVER['SERVER_SOFTWARE'], 'Microsoft-IIS/' ) + 14 ) ) >= 7;

/**

* Test if the current browser runs on a mobile device (smart phone, tablet, etc.)

* @return bool true|false

function wp_is_mobile() {

static $is_mobile;

if ( isset($is_mobile) )

return $is_mobile;

if ( empty($_SERVER['HTTP_USER_AGENT']) ) {

$is_mobile = false;

} elseif ( strpos($_SERVER['HTTP_USER_AGENT'], 'Mobile') !== false // many mobile devices (all iPhone, iPad, etc.)

|| strpos($_SERVER['HTTP_USER_AGENT'], 'Android') !== false

|| strpos($_SERVER['HTTP_USER_AGENT'], 'Silk/') !== false

|| strpos($_SERVER['HTTP_USER_AGENT'], 'Kindle') !== false

|| strpos($_SERVER['HTTP_USER_AGENT'], 'BlackBerry') !== false

|| strpos($_SERVER['HTTP_USER_AGENT'], 'Opera Mini') !== false

|| strpos($_SERVER['HTTP_USER_AGENT'], 'Opera Mobi') !== false ) {

$is_mobile = true;

} else {

$is_mobile = false;

}

return $is_mobile;

}

: WordPressを読む　17 /blog/wp-includes/pomo/entry.php
目次1 /blog/wp-includes/pomo/entry.php2 読込 …

: WordPressを読む　55 /blog/wp-includes/class.wp-dependencies.php
目次1 /blog/wp-includes/class.wp-dependenc …

: WordPressを読む　25-11 /blog/wp-includes/formatting.php 11
目次1 /blog/wp-includes/formatting.php 112 …

: WordPressを読む　27-5 /blog/wp-includes/query.php 5
目次1 /blog/wp-includes/query.php 52 WP_Qu …

: ソースコードの読み方　準備
get_included_files()関数を使います。 PHPマニュアルに載っ …

PREV: WordPressを読む　62 /blog/wp-includes/canonical.php
NEXT: WordPressを読む　64 /blog/wp-includes/class-wp-embed.php

2024年4月
月	火	水	木	金	土	日
« 4月
1	2	3	4	5	6	7
8	9	10	11	12	13	14
15	16	17	18	19	20	21
22	23	24	25	26	27	28
29	30

WordPressを読む 63 /blog/wp-includes/shortcodes.php

/blog/wp-includes/shortcodes.php

WordPressを読む　63 /blog/wp-includes/shortcodes.php