• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「テンプレートタグ/the content」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(1 版)
(用例などがあるので英語版を挿入・微調整、未翻訳。Naoさんの説明とどう融合させるのがいいかな)
8行目: 8行目:
 
*** false(デフォルト。記事全体を出力する)
 
*** false(デフォルト。記事全体を出力する)
 
** more_file (文字列)- パーマリンクのリンク先として使うファイル名。現時点のバージョンではこの引数を指定してもデフォルト値が採用される。
 
** more_file (文字列)- パーマリンクのリンク先として使うファイル名。現時点のバージョンではこの引数を指定してもデフォルト値が採用される。
 +
 +
 +
{{NeedTrans|以下|(上の説明とマージしつつ翻訳?そのまま残した方が簡潔で見やすい?)}}
 +
 +
== 説明 ==
 +
 +
Displays the contents of the current post. This tag must be within [[The Loop]].
 +
 +
If the quicktag [[Writing Posts#Visual Versus HTML Editor|<tt><nowiki><!--more--></nowiki></tt>]] is used in a post to designate the "cut-off" point for the post to be excerpted, the_content() tag will only show the excerpt up to the <tt><nowiki><!--more--></nowiki></tt> quicktag point on non-single/non-[[用語集#Permalink|permalink]] post pages.  By design, <tt>the_content()</tt> tag includes a parameter for formatting the <tt><nowiki><!--more--></nowiki></tt> content and look, which creates a link to "continue reading" the full post.
 +
 +
:'''Note about <tt><nowiki><!--more--></nowiki></tt>''' :
 +
:* No whitespaces are allowed '''before''' the "more" in the <tt><nowiki><!--more--></nowiki></tt> quicktag. In other words <tt><nowiki><!-- more --></nowiki></tt> will ''not'' work!
 +
:* ''The <tt><nowiki><!--more--></nowiki></tt> quicktag will not operate and is ignored in [[テンプレート]], such as '''single.php''', where just one post is displayed.''
 +
:* Read [[Customizing the Read More]]/[[:en:Customizing the Read More|en]] for more details.
 +
 +
== 使い方 ==
 +
 +
<?php the_content( [[#Parameters|$more_link_text, $strip_teaser, $more_file]] ); ?>
 +
 +
[[テンプレートタグ/タグパラメータの渡し方#Tags with PHP function-style parameters|How to pass parameters to tags with PHP function-style parameters]]
 +
 +
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
 +
 +
; $more_link_text
 +
: (''文字列'')(オプション) The link text to display for the "more" link. 初期値は '(more...)'
 +
; $strip_teaser
 +
: (''論理値'')(オプション) Should the text before the "more" link be hidden (<tt>TRUE</tt>) or displayed (<tt>FALSE</tt>). 初期値はFALSE
 +
; $more_file
 +
: (''文字列'')(オプション) File the "more" link points to (no longer used). 初期値は The current file
 +
 +
== Examples ==
 +
 +
=== Designating the "More" Text ===<!-- Designating the "More" Text -->
 +
 +
Displays the content of the post and uses "Read more..." for the more link text when the <tt><nowiki><!--more--></nowiki></tt> Quicktag is used.
 +
 +
<?php the_content('Read more...'); ?>
 +
 +
=== Include Title in "More" ===<!-- Include Title in "More" -->
 +
 +
Similar to the above example, but thanks to [[テンプレートタグ/the title|the_title()]] tag and the ''display'' parameter, it can show "Continue reading ''ACTUAL POST TITLE''" when the <tt><nowiki><!--more--></nowiki></tt> Quicktag is used.
 +
 +
<?php the_content("Continue reading " . the_title(&#39;&#39;, &#39;&#39;, false)); ?>
 +
 +
=== Overriding Archive/Single Page Behavior ===<!-- Overriding Archive/Single Page Behavior -->
 +
 +
If the_content() isn't working as you desire (displaying the entire story when you only want the content above the <tt><nowiki><!--more--></nowiki></tt> Quicktag, for example) you can override the behavior with global $more.
 +
 +
<?php
 +
global $more;    // Declare global $more (before the loop).
 +
$more = 0;      // Set (inside the loop) to display content above the more tag.
 +
the_content("More...");
 +
?>
 +
 +
if you need to display all of the content:
 +
 +
<?php
 +
global $more;    // Declare global $more (before the loop).
 +
$more = 1;      // Set (inside the loop) to display all content, including text below more.
 +
the_content();
 +
?>
 +
 +
== Alternative Usage ==<!-- Alternative Usage -->
 +
 +
You may use [[関数リファレンス/get_the_content|get_the_content()]]/[[:en:Function Reference/get_the_content|en]] to return the content value instead of outputting it directly.  Example:
 +
 +
<?php $content = get_the_content(); ?>
 +
 +
'''Please note!''' [[関数リファレンス/get_the_content|get_the_content]]/[[:en:Function Reference/get_the_content|en]] will not have the following done to it and you are advised to add them until the core has been updated:
 +
 +
<?php
 +
$content = apply_filters('the_content', $content);
 +
$content = str_replace(']]>', ']]&amp;gt;', $content);
 +
?>
 +
 +
== Changelog ==
 +
 +
Since: 0.71
 +
 +
==Source File==
 +
 +
<tt>the_content()</tt> is located in {{BrowseSource|wp-includes/post-template.php}}.
 +
 +
{{原文|Template Tags/the_content|82001}}<!-- 02:21, 10 January 2010 Bono 版 -->
 +
 +
== Related ==
 +
 +
{{Tag Post Tags}}
 +
 +
{{PHP Function Tag Footer}}
 +
 +
{{DEFAULTSORT:The_content}}
  
 
[[en:Template Tags/the_content]]
 
[[en:Template Tags/the_content]]

2010年1月10日 (日) 11:42時点における版

  • 書式: <?php the_content('more_link_text', strip_teaser, 'more_file'); ?>
  • 説明: 記事の本文を出力。本文中に<!--more-->クイックタグがある場合、それより前の内容のみを表示させることもできる。
  • 位置: ループ内
  • 引数:
    • more_link_text (文字列)- <!--more-->>以降を読むためのリンク。デフォルト値は「(more...)」。
    • strip_tease (true/false)- <!--more-->以降の記事を隠すかどうか。
      • true(<!--more-->より前の記事のみを出力する)
      • false(デフォルト。記事全体を出力する)
    • more_file (文字列)- パーマリンクのリンク先として使うファイル名。現時点のバージョンではこの引数を指定してもデフォルト値が採用される。


このページ「テンプレートタグ/the content」は以下未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています。(上の説明とマージしつつ翻訳?そのまま残した方が簡潔で見やすい?)

説明

Displays the contents of the current post. This tag must be within The Loop.

If the quicktag <!--more--> is used in a post to designate the "cut-off" point for the post to be excerpted, the_content() tag will only show the excerpt up to the <!--more--> quicktag point on non-single/non-permalink post pages. By design, the_content() tag includes a parameter for formatting the <!--more--> content and look, which creates a link to "continue reading" the full post.

Note about <!--more--> :
  • No whitespaces are allowed before the "more" in the <!--more--> quicktag. In other words <!-- more --> will not work!
  • The <!--more--> quicktag will not operate and is ignored in テンプレート, such as single.php, where just one post is displayed.
  • Read Customizing the Read More/en for more details.

使い方

<?php the_content( $more_link_text, $strip_teaser, $more_file ); ?>

How to pass parameters to tags with PHP function-style parameters

パラメータ

$more_link_text
文字列)(オプション) The link text to display for the "more" link. 初期値は '(more...)'
$strip_teaser
論理値)(オプション) Should the text before the "more" link be hidden (TRUE) or displayed (FALSE). 初期値はFALSE
$more_file
文字列)(オプション) File the "more" link points to (no longer used). 初期値は The current file

Examples

Designating the "More" Text

Displays the content of the post and uses "Read more..." for the more link text when the <!--more--> Quicktag is used.

<?php the_content('Read more...'); ?>

Include Title in "More"

Similar to the above example, but thanks to the_title() tag and the display parameter, it can show "Continue reading ACTUAL POST TITLE" when the <!--more--> Quicktag is used.

<?php the_content("Continue reading " . the_title('', '', false)); ?>

Overriding Archive/Single Page Behavior

If the_content() isn't working as you desire (displaying the entire story when you only want the content above the <!--more--> Quicktag, for example) you can override the behavior with global $more.

<?php 
global $more;    // Declare global $more (before the loop).
$more = 0;       // Set (inside the loop) to display content above the more tag.
the_content("More...");
?>

if you need to display all of the content:

<?php 
global $more;    // Declare global $more (before the loop).
$more = 1;       // Set (inside the loop) to display all content, including text below more.
the_content();
?>

Alternative Usage

You may use get_the_content()/en to return the content value instead of outputting it directly. Example:

<?php $content = get_the_content(); ?>

Please note! get_the_content/en will not have the following done to it and you are advised to add them until the core has been updated:

<?php
$content = apply_filters('the_content', $content);
$content = str_replace(']]>', ']]&gt;', $content);
?>

Changelog

Since: 0.71

Source File

the_content() is located in wp-includes/post-template.php.

最新英語版: WordPress Codex » Template Tags/the_content最新版との差分

Related

投稿タグ: body_class(), next_image_link(), next_post_link(), next_posts_link(), post_class(), post_password_required(), posts_nav_link(), previous_image_link(), previous_post_link(), previous_posts_link(), single_post_title(), sticky_class(), the_category(), the_category_rss(), the_content(), the_content_rss(), the_excerpt(), the_excerpt_rss(), the_ID(), the_meta(), the_shortlink(), the_tags(), the_title(), the_title_attribute(), the_title_rss(), wp_link_pages(),


テンプレートタグへの PHP 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。