WordPress用 Twitter プラグインは、twitter_shareWordPress ショートコードを使ったツイートボタンの生成をサポートしています。あなたが投稿したコンテンツのエリアにショートコードを含めるか、 do_shortcode WordPress functionを使用してPHP でshortcode を精査することによって、WordPress の投稿にツイートボタンを追加します。
例:
Share this post: [twitter_share]
Tweet ButtonThe Twitter plugin for WordPress supports generating a Tweet button through the Example: Share this post: [twitter_share] |
ツイート書き込みボックスに、あらかじめ強調した状態で埋め込むテキスト文。
ショートコードで設定されたtext 値は、 post editorで設定されたtext 値を上書きします。
サンプル値: Hello world
ツイートに含めるハッシュタグのコンマ区切り一覧。
ショートコードで設定されたhashtags 値は、 post editorで設定されたhashtags 値を上書きします。
サンプル値: cute,funny
ツイートに含めるURL。
Automatically set to the permalink value for the post after passing through the twitter_url filter when executed inside the loop.
サンプル値: https://example.com/
Twitter ユーザー名に対して、ツイート元の属性を付与する。
既定では、Twitter 設定ページのサイト属性項目で設定されたTwitter 名が入ります。
twitter_via_usernameフィルタによって上書きされることがあります。
サンプル値: TwitterDev
拡散するコンテンツに関連するTwitter アカウントをコンマ区切りで一覧にしたもの。 各Twitter アカウント名の後ろには、オプションでセミコロンと関連内容の説明を付けます。
この関連アカウントはツイート後に表示され、ツイート主にこのアカウントをフォローするよう勧めます。
Defaults to the post author’s Twitter username when executed in the loop and the author has defined a Twitter username in the user profile’s contact field.
サンプル値: twittermusic:Music,twittermedia:Media
新しいツイートに、別のツイートへリプライするための対象ツイートIDを指定します。
サンプル値: 463440424141459456
ツイートボタンに、指定したURLを参照しているツイート数を表示します。既定ではボタンの左が右に表示されます。
ツイートカウントを省略するにはnone を設定し、ツイートカウントをボタンの上に表示するには vertical を設定します。
サンプル値: none
Specify a count URL to be used to count the number of Tweets referencing your URL if you have modified your share URL.
サンプル値: https://example.com/
生成されたiframeでボタンを並べて表示するには left か rightを設定します。
サンプル値: right
大きめのツイートボタンを表示するにはlargeを設定します。
サンプル値: large
Supported shortcode parameters
text
optional
Pre-populated text highlighted in the Tweet composer. A text value provided in a shortcode overrides the text value provided in the post editor. Example Value:
hashtags
optional
A comma-separated list of hashtags to include with the Tweet. A hashtags value provided in a shortcode overrides the hashtags value provided in the post editor. Example Value:
url
optional
URL included with the Tweet. Automatically set to the permalink value for the post after passing through the Example Value:
via
optional
Attribute the source of a Tweet to a Twitter username. Defaults to the Twitter username provided in the Site Attribution section of the Twitter settings page. May be overridden by the Example Value:
related
optional
A comma-separated list of Twitter accounts related to the shared content with an optional description of the relation provided after a semicolon. Related accounts may be displayed after a Tweet to encourage a Tweet author to follow an account. Defaults to the post author’s Twitter username when executed in the loop and the author has defined a Twitter username in the user profile’s contact field. Example Value:
in_reply_to
optional
Specify a Tweet ID for a new Tweet to appear in reply to another Tweet. Example Value:
count
optional
A Tweet button displays the number of Tweets referencing the specified URL to the left or right of the button by default. Set to Example Value:
counturl
optional
Specify a count URL to be used to count the number of Tweets referencing your URL if you have modified your share URL. Example Value:
align
optional
Set to Example Value:
size
optional
Set to Example Value: |
WordPress フィルターのshortcode_atts_twitter_shareに渡された連想配列にしたがって動作することで、ウェブサイトはサイト全体のツイートボタンに関する設定を設定できます。
Functions acting on the filter should treat the value associated with the hashtags key as a positional array of unique values. The value associated with the related key should be treated as an associative array with keys of Twitter usernames and values describing each username (or an empty string if no description).
Example:
/**
* Always show a large button
*
* @param array $options parsed options with defaults applied
* @param array $defaults default values of a Tweet button
* @param array $attributes user-defined shortcode attributes
*
* @return array options array with our customization applied
*/
function twitter_share_custom_options( $options, $defaults, $attributes )
{
$options['size'] = 'large';
return $options;
}
add_filter( 'shortcode_atts_twitter_share', 'twitter_share_custom_options', 10, 3 );
Site-wide customization using a filterA website may programmatically set Tweet button parameters by acting on the associative array passed to the Functions acting on the filter should treat the value associated with the Example:
/**
* Always show a large button
*
* @param array $options parsed options with defaults applied
* @param array $defaults default values of a Tweet button
* @param array $attributes user-defined shortcode attributes
*
* @return array options array with our customization applied
*/
function twitter_share_custom_options( $options, $defaults, $attributes )
{
$options['size'] = 'large';
return $options;
}
add_filter( 'shortcode_atts_twitter_share', 'twitter_share_custom_options', 10, 3 );
|