word press メモ


word press を行う上でのメモ

<?php
 function xxx_test(){
   echo "テストで電話をしよう"；
}
?>
と記述して、

<?php
xxx_test();
?>

と記述すると、
「テストで電話をしよう」
と表示される。

get_header()や、have_posts()等も同様の考え。

（WordPressの関数について）
①
画像ファイルのURLをWordPress用に相対パスを修正する場合、、
<?php echo esc_url(get_template_directory_uri() ); ?>
この関数を用いると、テーマディレクトリーのURLを取得するので、
その中のどの画像かを設定すれば、その画像を取り込む事ができる。

esc_url 関数：　URLの無害化

②
テーマディレクトリーまでのurlではなく、
webサイトに基づくｕｒｌを取得したい場合、
(home_url()
を記載すると、wordpressのホームｕｒｌを返してくれます。
※　esc_urlで無効化してから使用する。
記載方法は、以下。
<?php echo esc_url(home_url() ); ?>

phpの無害化関数（エスケープ関数）
・wordpressには、
esc_urlの様にデータを安全に扱える様に無害化してくれる関数が用意されている。
esc_html(),esc_attr(),esc_tetarea()などがある。


3 
<html lang="ja">
のlang属性や
  <meta charset="UTF-8">
は、wordpressに設定してあるものを出力することが可能。
<html>には、
language_attributes()
と記述するだけで、言語コードが出力されます。
  <meta charset="UTF-8">には、
bloginfo('charset')と指定します。
bloginfo（）というテンプレートは、wordpressの管理画面の一般設定で入力された値などを出力させることが出来る。

テンプレートタグのテンプレートタグのbloginfoは、使用中のWordPressブログに関するさまざまな情報を出力することができる。
詳しくは、ワードプレス日本語版テンプレート参照。
https://wpdocs.osdn.jp/%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%82%BF%E3%82%B0/bloginfo

(bloginfoで良く使うタグ）
１
'name' - 管理画面の「設定 > 一般」で設定された「サイトのタイトル」を表示するものです。このデータは wp_options テーブルの "blogname" レコードから取得されるものです。
２
'description' - 管理画面の「設定 > 一般」で設定された「キャッチフレーズ」を表示するものです。このデータは wp_options テーブルの "blogdescription" レコードから取得されるものです。
３
'url' - 管理画面の「設定 > 一般」で設定された「サイトアドレス (URL)」を表示するものです。このデータは wp_options テーブルの "home" レコードから取得されるものです。 home_url() 関数の出力を用いることをお奨めします。
４
'stylesheet_url' - プライマリーな CSS (usually style.css) ファイルの URL を表示します。 get_stylesheet_uri() 関数の出力を用いることを推奨します。

５
template_url' / 'template_directory' - アクティブなテーマのディレクトリー URL を表示します。 ('template_directory' は Version 2.6 以前ではローカルパスを表示していました。ハック的な代替策は get_theme_root() と get_template() を参照してください)。 子テーマの中では、 get_bloginfo('template_url') と get_template() はどちらも親テーマのディレクトリーを返します。そのため、親テーマでは get_template_directory_uri() を、子テーマでは get_stylesheet_directory_uri() を使うよう考慮してください。

米これらは覚えておくこと。

body_class()関数を記述すると、
表示しているページに合わせて、class属性が出力される。これをbodyタグに記述します。

（ループ処理）
・have_posts()　投稿があるかどうか判別するための関数
・the_post() 投稿を取得し、展開するための関数
<?php while have_posts())（投稿がある限り）、:the_post();（投稿を取得し、展開する。） ?>
の意味。

投稿IDと投稿classを追加する方法
・the_ID（）関数は、現在の投稿番号を出力する関数
         固有のIDを出力する際に使用
・post_class()は、class属性を追加するための関数

タイトルをつけるときは、
・the_title() テンプレートタグを使用する

アイキャッチ画像をテンプレートタグに修正する方法
・has_post_thumbnail関数は、投稿にアイキャッチ画像が登録されているかどうかを判別している。
・アイキャチ画像が登録されていれば、
<div class="entry-thumbnail">が表示される。
画像ファイルを呼び出す方法は、
the_post_thumbnail()というテンプレートタグを使用する

・array（）は、<img>に与える属性と値を記述でき、array内に記述することで、「配列」というデータにして、「属性＝＞値」となるようにカンマ区切りで複数指定できる。

・ 'class' => 'img-thumbnail img-responsive`と記述すると、<img>のclass属性にing-thumbnailとimg-responsiveを追加できる。

・alt属性とtitle属性に記述されている「the_title_attribute('echo=0')は、特殊文字をエンティティ化しつつ、投稿のタイトルをphpスクリプトの値を与え、画像ファイルの属性値を取得しています。

・テンプレートタグについての説明
https://wpdocs.osdn.jp/%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%82%BF%E3%82%B0/the_post_thumbnail
・現在の投稿について、投稿編集画面で設定されたアイキャッチ画像（以前は投稿サムネイルと呼ばれていました）を表示します。
このタグはループ内でのみ使えます。
get_the_post_thumbnail() を利用することにより、他の投稿のアイキャッチ画像を表示できます。
has_post_thumbnail() タグを使用することにより、アイキャッチ画像が投稿に追加されているかどうかをチェックすることができます。
アイキャッチ画像を有効にするには、使用しているテーマの functions.php ファイルに add_theme_support( 'post-thumbnails' ); を追加する必要があります。投稿サムネイルも参照してください。

用語集より：
http://wpdocs.osdn.jp/%E7%94%A8%E8%AA%9E%E9%9B%86

文字実体参照
文字実体参照とは、特殊記号を HTML で表示させるための方法。例えば「小なり記号（<）」や「大なり記号（>）」は HTML タグ構造の一部に含まれており、タグ用に使用が限定されている。もしサイト内でこれらの記号をそのまま表示させたい場合は、文字実体参照を使う。例は以下の通り。
小なり記号（<）: &lt;
大なり記号（>）: &gt;
また、数値文字参照で書く方法もある。その場合、音符記号（♪）は "&#9834;"（10進数）または "&#x266A;"（16進数）となる。
関連ページ: 面白い実体参照文字/en
外部リンク: 文字参照（ウィキペディア）
最新英語版： WordPress Codex » Glossary#Character Entity

本文を出力するテンプレートタグは、the_content()です。

改ページのテンプレートタグは、wp_link_pages()です。

テンプレートタグの説明
https://wpdocs.osdn.jp/%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%82%BF%E3%82%B0/wp_link_pages

before 
(文字列) リンクの前のテキスト。デフォルトは <p>Pages:。
after 
(文字列) リンクの後のテキスト。デフォルトは</p>。

link_before 
(文字列) リンクテキストの前のテキスト。デフォルトは空文字列。バージョン 2.7 以降。
link_after 
(文字列) リンクテキストの後のテキスト。デフォルトは空文字列。バージョン 2.7 以降。

pagelink 
(文字列) ページ番号のフォーマット。文字列内の % が番号に置き換えられる。例えば Page % は「Page 1」、「Page 2」などを生成する。デフォルトは '%'。

・separatorには、区切り文字を指定します。
separator 
(文字列) ページ番号の間のテキスト（適切な場合）。デフォルトはスペース 1 文字（改行可能）。（WordPress 3.6 以降で有効）

・投稿者を表示させるテンプレートタグは、
the_author_posts_link（）は、投稿者を表示するタグ
・時間を表示させるタグは、
the_time(),
・投稿のタグ表示は、the_tags()
・the_time()の引数は、日付のフォーマットしてい。 Y は年数、ｍは、２桁の月、ｄは、２桁の日付です。
・the_tags()の引数は、「the_tags(タグの前に表示する文字列）、各タグの間の文字列、タグの後に表示する文字列）」となっている。

・foreach文は、配列の要素があるだけ、繰り返しするといった処理

・<aside class="recommend">は、関連記事のコンテンツ

・要素全体をif()文で。

・WP_Query()関数で、投稿データの取得を行い、
$recommend_postsに保存しています。

・アイキャッチ画像を表示する際のｉｆ文に、
has_post_thumnail()で判別を行い、
else(でなかったら）、、この後の処理を行うの意味。

・投稿リンク先を呼び出すテンプレートタグは、
the_permalink()です。
・タイトルを呼び出すテンプレートタグは、
wp_trim_wordｓ（）関数です。
例；
get_the_title(),30 
の意味は、取得したタイトルの文字列を30まで表示しれ、それ以上は省略記号（・・・）を表示する関数。

・WP_Query()関数で表示されるページとは、新たに投稿データーを取得した場合、この情報を一旦リセットせねばならない。

・if($recommend_posts->have_posts())の記述が終わるendif；の最後に取得データをリセットするためのwp_reset_postdata(）関数を実行する。

・前ページ、後ページボタンの作成
・previous_post_link()　前ページ
・next_post_link()　後ページ
％link　はフォーマット指定。

応用：
投稿ブロックをパーツテンプレート化する方法として、
・get_template_part()関数は、引数を与えることで、読み込むテンプレートを自由に指定するること可能。
※このマニュアルの場合だと、single.phpの投稿部分をcontent.phpとして投稿部分だけをcontent.phpの中に記述させ、
それを、get_template_part('content')；として呼び出せば、良い。
https://wpdocs.osdn.jp/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/get_template_part

テンプレートタグ：post
https://wpdocs.osdn.jp/%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%82%BF%E3%82%B0/post_class

the_IDは、固有のIDをを出力するもの。

<a> aタグはリンクの出発点
<a href=""> リンク先を表示する。

・the_excerpt()関数
抜粋を表示する。　110文字まで抜粋で表示される。
・「...」を表示する場合は、
the_excerpt(more)とする。
https://wpdocs.osdn.jp/%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%82%BF%E3%82%B0/the_excerpt
を参照。

・投稿者を表示するテンプレートタグは、
the_author_post_link()を使う
・時間の表示は、
the_time()を使う
・投稿タグ表示は、
the_tags（）を使う
・投稿タグがそれぞれの投稿に使われているかどうかを判別する為に、
if()文の式に、the_tags()を使う

・投稿リンクを出力するテンプレートタグは、
the_permalink();です。

previous_post_link　とpreious_post_link　の違い

previous_posts_link
next_posts_link
これらは、アーカイブ、カテゴリなどの一覧ページで使用し、
一覧ページごとに前後ページに移動できる。

previous_post_link
next_post_link
こちらは、各投稿ページごとの前後ページに移動。
postか、postsかを注意。
パラメータの使い方が違うので注意必要。
例）
<?php previous_posts_link(‘&laquo; prev page’); ?>
<?php previous_post_link(‘%link’, ‘&laquo; prev page’, TRUE); ?>

・画像ファイルと画像ファイルのキャプションを出力する場所として、画像ファイルを出力するテンプレートタグは、
wp_get_attachment_image()です。
一つ目の引数は、IDを指定しますが、get_the_ID ()関数で、投稿IDを取得することが出来る。
２つ目の引数は、表示する画像ファイルのサイズを指定します。
書き方例：wp_get_attachment_image( get_the_ID(), 'large' );
指定したIDの投稿IDの画像データは、大きさは、ｌａｒｇｅで表示する、といった指定となります。

・キャプションを表示する、テンプレートタグは、
the_excerpt（）関数を使用します。
・画像ファイルのキャプションがあるかどうかは、
・has_excerpt（）
で確認します。

・サイドバーの登録方法は、
function　phpにて、
register_sidebar（）関数でサイドバーの登録を行います。

・ウィジット用のサイドバーを表示するパーツテンプレートを呼び出すためには、
①　is_acitve_sidebar()関数で、ウィジェットがあるかどうか判別します。
　引数に指定するのは、register_sidever(）で指定したidです。
サイドバーがあれば、
dynamic_sidebar()の引数に実行したいサイドバーのｉｄを入力することで、指定できる。

・the_archive_title（）；関数は、
表示しているアーカイブページのタイトルを自動で取得する関数、

GIMP 作業用メモ
・竹をイメージした、文字（英字）
　フォント名　：bamboo gothic