[2018年]WordPressのfunctions.phpに記載する項目まとめ
WordPressサイトを制作する際の機能の追加は、基本的に以下の2通りに分かれます。
1. プラグインを利用
2. テンプレートファイルである「functions.php」ファイルに記載する
1の場合は「プラグインで運用したほうが簡単」「テーマ変更の際に左右されない」というメリットがあり、
一方で2では「余計なプラグインをインストールしなくていい」というメリットがあります。
どちらもメリット・デメリットがあるためどちらを選択するかは制作の際に予め決めておくことが必要となります。
ここでは、オリジナルテーマ制作をよく行っているhighfivecreateがWordPressサイト制作の際に、functions.phpによく記載する機能を一覧にまとめました。
※詳細項目が作成出来次第リンクします。
有効度が高いもの
- WPのバージョンやrel=“shortlink”、RSDなど勝手に表示される不必要な読込を非表示
- 非ログイン状態でのREST API エンドポイントを無効に namespaces で 例外を追加（例えばcontactform7の場合など）
- WPのjqueryは使わないでCDNを読み込む（ただし管理画面はWP側のjqueryをinclude） ※ローカルで動かない場合の変更方法も明記
- cssとjsを「wp_enqueue_scripts」「enqueue_style_script」にて読込 ※キャッシュ対策として更新日時のパラメータを付与
- WordPress4.2から利用可能になった絵文字を読込むscriptとstyleを無効化する
- 管理画面の固定ページのみビジュアルエディタ表示を無効
- 固定ページのみ自動的に付与されるpタグやbrタグを無効
- 管理画面にオリジナルのSEOセッティングができるフィールドを追加（Title, Keywords, Description, noindex）
- 管理者以外の管理画面の見せ方をカスタマイズ
- スラッグ名が日本語だったら自動的にid付与する
全て一括にまとめたソースコード
上記のコードを全て一括にまとめたソースコードです。コメントアウトしている箇所や実際の利用方法などは各ページに記載した説明をお読み下さい。
|
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 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 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 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 |
<?php /* * WPのバージョンやrel=“shortlink”、RSDなど勝手に表示される不必要な読込を非表示 */ //RSS関係の出力を削除 function digwp_disable_feed() { wp_die( __( '<h1>Feed not available, please visit our <a href=""' . get_bloginfo('url') . '"">Home Page</a>!</h1>')); } add_action( 'do_feed', 'digwp_disable_feed', 1); add_action( 'do_feed_rdf', 'digwp_disable_feed', 1); add_action( 'do_feed_rss', 'digwp_disable_feed', 1); add_action( 'do_feed_rss2', 'digwp_disable_feed', 1); add_action( 'do_feed_atom', 'digwp_disable_feed', 1); // 不必要な読込を非表示 // generator remove_action( 'wp_head', 'wp_generator'); // rel="shortlink" remove_action( 'wp_head', 'wp_shortlink_wp_head', 10, 0 ); // WLW(Windows Live Writer) wlwmanifest.xml remove_action( 'wp_head', 'wlwmanifest_link'); // RSD xmlrpc.php?rsd remove_action( 'wp_head', 'rsd_link'); /* * REST APIを無効にする * * Embed以外 * * License: GPLv2 or later */ function nendebcom_deny_restapi_except_embed( $result, $wp_rest_server, $request ){ $namespaces = $request->get_route(); // /oembed/1.0 if( strpos( $namespaces, 'oembed/' ) === 1 ){ return $result; } // /contact-form-7/v1 if( strpos( $namespaces, 'contact-form-7/' ) === 1 ){ return $result; } return new WP_Error( 'rest_disabled', __( 'The REST API on this site has been disabled.' ), array( 'status' => rest_authorization_required_code() ) ); } add_filter( 'rest_pre_dispatch', 'nendebcom_deny_restapi_except_embed', 10, 3 ); /* * WPのjqueryは使わないでCDNを読み込む（ただし管理画面はWP側のjqueryをinclude） */ function change_jquery() { if( !is_admin() ){ wp_deregister_script('jquery'); wp_enqueue_script('jquery', '//cdn.jsdelivr.net/jquery/1.11.3/jquery.min.js', array(), '1.11.3', true); } } add_action('init', 'change_jquery'); /* * cssとjsを「wp_enqueue_scripts」「enqueue_style_script」にて読込 ※キャッシュ対策として更新日時のパラメータを付与 */ add_action( 'wp_enqueue_scripts', 'enqueue_style_script' ); if( ! function_exists( 'enqueue_style_script' ) ) { function enqueue_style_script() { wp_enqueue_style( 'style-css', get_stylesheet_directory_uri() . '/css/style.css', false, date('YmdHis', filemtime(get_stylesheet_directory() . '/css/style.css')) ); wp_enqueue_script( 'common-js', get_stylesheet_directory_uri().'/js/common.js', array(), date('YmdHis', filemtime(get_stylesheet_directory() . '/js/common.js')), true ); } } /* * WordPress4.2から利用可能になった絵文字を読込むscriptとstyleを無効化 */ function disable_emoji() { remove_action( 'wp_head', 'print_emoji_detection_script', 7 ); remove_action( 'admin_print_scripts', 'print_emoji_detection_script' ); remove_action( 'wp_print_styles', 'print_emoji_styles' ); remove_action( 'admin_print_styles', 'print_emoji_styles' ); remove_filter( 'the_content_feed', 'wp_staticize_emoji' ); remove_filter( 'comment_text_rss', 'wp_staticize_emoji' ); remove_filter( 'wp_mail', 'wp_staticize_emoji_for_email' ); } add_action( 'init', 'disable_emoji' ); /* * 管理画面の固定ページのみビジュアルエディタ表示を無効 */ function disable_visual_editor_in_page(){ global $typenow; if( $typenow == 'page' ){ add_filter('user_can_richedit', 'disable_visual_editor_filter'); } } function disable_visual_editor_filter(){ return false; } add_action( 'load-post.php', 'disable_visual_editor_in_page' ); add_action( 'load-post-new.php', 'disable_visual_editor_in_page' ); /* * 固定ページのみ自動的に付与されるpタグやbrタグを無効 */ function disable_page_wpautop() { if ( is_page() ) remove_filter( 'the_content', 'wpautop' ); } add_action( 'wp', 'disable_page_wpautop' ); /* * 管理画面にオリジナルのSEOセッティングができるフィールドを追加（Title, Keywords, Description, noindex）※WordPress 4.1以降 */ // カスタムフィールド追加 add_action('admin_menu', 'add_custom_fields'); add_action('save_post', 'save_custom_fields'); function add_custom_fields() { add_meta_box( 'my_sectionid', 'SEO設定', 'my_custom_fields', 'page'); add_meta_box( 'my_sectionid', 'SEO設定', 'my_custom_fields', 'post'); //add_meta_box( 'my_sectionid', 'SEO設定', 'my_custom_fields', 'my-custom-type'); //カスタム投稿タイプを追加したらここに追加する } function my_custom_fields() { global $post; $meta_title = get_post_meta($post->ID,'meta_title',true); $meta_keywords = get_post_meta($post->ID,'meta_keywords',true); $meta_description = get_post_meta($post->ID,'meta_description',true); $noindex = get_post_meta($post->ID,'noindex',true); if($noindex==1){ $noindex_c="checked";} else{$noindex_c= "/";} echo '<div class="pw_seo_custom">'; echo '<p class="label"><label for="pw_seo_title">タイトル設定(title)</label>タイトルを個別に設定したい場合ここに入力します。タイトルとページ名が同じで問題ない場合は入力の必要はありません。<br>'; echo '<input type="text" name="meta_title" value="'.esc_html($meta_title).'" size="100%" id="pw_seo_title" /></p>'; echo '<p class="label"><label for="pw_seo_keywords">キーワード設定(meta keywords)</label>設定したいキーワードをカンマ区切りで設定します。2〜5個程 （例：キーワード1, キーワード2, キーワード3）<br>'; echo '<input type="text" name="meta_keywords" value="'.esc_html($meta_keywords).'" size="100%" id="pw_seo_keywords" /></p>'; echo '<p class="label"><label for="pw_seo_description">説明文設定(meta description)</label>このページの説明文を設定します。文字数は多くても100文字前後にします。<br>設定しない場合、最初の120文字を表示します<br>'; echo '<textarea name="meta_description" size="100%" id="pw_seo_description" cols="80" rows="5"/>'.esc_html($meta_description).'</textarea></p>'; echo '<p class="label"><label for="pw_seo_noindex">検索結果に表示しない(noindex)</label>このページを検索結果に表示しないようにする場合チェックすることにより、metaタグに"no index"が追加されます。<br>質の低いコンテンツや、重複しているコンテンツの場合チェックすることをお勧めします。<br>'; echo '<input type="checkbox" name="noindex" value="1" id="pw_seo_noindex" ' . $noindex_c . '> <label for="pw_seo_noindex">検索結果から非表示</label></p>'; echo '</div>'; } // カスタムフィールドの値を保存 function save_custom_fields( $post_id ) { if(!empty($_POST['meta_title'])) update_post_meta($post_id, 'meta_title', $_POST['meta_title'] ); else delete_post_meta($post_id, 'meta_title'); if(!empty($_POST['meta_keywords'])) update_post_meta($post_id, 'meta_keywords', $_POST['meta_keywords'] ); else delete_post_meta($post_id, 'meta_keywords'); if(!empty($_POST['meta_description'])) update_post_meta($post_id, 'meta_description', $_POST['meta_description'] ); else delete_post_meta($post_id, 'meta_description'); if(!empty($_POST['noindex'])) update_post_meta($post_id, 'noindex', $_POST['noindex'] ); else delete_post_meta($post_id, 'noindex'); } //titleタグに出力 function custom_title() { echo '<title>'; if (is_home()) { bloginfo('name'); echo ' | '; bloginfo('description'); } else { $has_title = get_post_meta(get_the_ID(),'meta_title',true); $no_set_title = wp_title('',false); if(wp_title('',false)) { $no_set_title .= ' | '; $no_set_title .= get_bloginfo('name'); } ; //投稿ページのみ、設定したタイトルのみを表示（サイト名は出力しない） if (is_single()) { echo ($has_title) ? $has_title : $no_set_title; } else { echo ($has_title) ? $has_title . ' | ' . get_bloginfo('name') : $no_set_title; } } echo '</title>' . "\n"; } remove_action( 'wp_head', '_wp_render_title_tag', 1 ); add_action( 'wp_head', 'custom_title', 1 ); //keywordsを出力 function custom_keywords() { $has_keywords = get_post_meta(get_the_ID(),'meta_keywords',true); echo ($has_keywords) ? '<meta name="keywords" content="'.$has_keywords.'">'."\n" : ''; } add_action( 'wp_head', 'custom_keywords', 1); //descriptionを出力 function custom_description() { echo '<meta name="description" content="'; if (is_category()) { $cat = get_the_category(); $cat = $cat[0]; $cat_id = $cat->cat_ID; echo strip_tags(category_description($cat_id)); } else { $has_description = get_post_meta(get_the_ID(),'meta_description',true); //get_post_content $the_postid = get_the_ID(); $the_post_content = get_post($the_postid); $content = $the_post_content-> post_content; $content = str_replace(array("\r\n","\r","\n"), '', $content); //deleat nbsp echo ($has_description) ? $has_description : mb_substr(strip_tags($content), 0, 120) . '…'; } echo '">'."\n"; } add_action( 'wp_head', 'custom_description', 1); function custom_noindex() { if( (get_post_meta(get_the_ID(),'noindex',true)==1) || (is_archive()) ) { echo '<meta name="robots" content="noindex">'."\n"; } } add_action( 'wp_head', 'custom_noindex', 1); /* * 管理者以外の管理画面の見せ方をカスタマイズ */ if (!current_user_can('edit_users')){ //ヘッダーの更新情報を非表示＆APIバージョン確認を行わない add_filter( 'pre_site_transient_update_core', '__return_zero' ); remove_action( 'wp_version_check', 'wp_version_check' ); remove_action( 'admin_init', '_maybe_update_core' ); //ダッシュボードの不要な項目を非表示 function example_remove_dashboard_widgets() { global $wp_meta_boxes; unset($wp_meta_boxes['dashboard']['normal']['core']['dashboard_incoming_links']); // 被リンク unset($wp_meta_boxes['dashboard']['normal']['core']['dashboard_plugins']); // プラグイン unset($wp_meta_boxes['dashboard']['normal']['core']['dashboard_activity']); // アクティビティ unset($wp_meta_boxes['dashboard']['side']['core']['dashboard_quick_press']); // クイック投稿 unset($wp_meta_boxes['dashboard']['side']['core']['dashboard_primary']); // WordPressブログ unset($wp_meta_boxes['dashboard']['side']['core']['dashboard_secondary']); // WordPressフォーラム if (current_user_can('author')){ //投稿者のみ非表示にする unset($wp_meta_boxes['dashboard']['normal']['core']['dashboard_right_now']); // 概要 } } add_action('wp_dashboard_setup', 'example_remove_dashboard_widgets'); //右上のヘルプを非表示 function disable_help_link() { echo '<style type="text/css"> #contextual-help-link-wrap {display: none !important;} </style>'; } add_action('admin_head', 'disable_help_link'); // 管理バーの項目を非表示 function remove_admin_bar_menu( $wp_admin_bar ) { $wp_admin_bar->remove_menu( 'wp-logo' ); // WordPressシンボルマーク } add_action( 'admin_bar_menu', 'remove_admin_bar_menu', 70 ); // ウィジェットを表示&不要な項目を非表示 function customize_theme_caps(){ $role = get_role( 'editor' ); $role->add_cap( 'edit_theme_options' ); remove_menu_page('edit-comments.php'); // コメント remove_menu_page('tools.php'); // ツール remove_submenu_page('themes.php', 'themes.php'); //外観>テーマ global $submenu; unset($submenu['themes.php'][6]); // Customize link remove_submenu_page('themes.php', 'nav-menus.php'); //外観>メニュー remove_submenu_page('themes.php', 'custom-header'); // 外観 -> カスタムヘッダー //remove_menu_page('wpcf7'); //コンタクトフォーム7 //remove_menu_page( 'edit.php?post_type=カスタム投稿名' ); //カスタム投稿の名称を設定 } add_action( 'admin_init', 'customize_theme_caps' ); //カスタマイザーの表示項目を調整 function customize_register_custom_demo( $wp_customize ) { $wp_customize->remove_section('title_tagline'); //サイト基本情報 $wp_customize->remove_section('colors'); //色 $wp_customize->remove_section('header_image'); //ヘッダーメディア remove_action( 'customize_register', array( $wp_customize->nav_menus, 'customize_register' ), 11 ); //メニュー //$wp_customize->remove_panel('widgets'); //ウィジェット $wp_customize->remove_section('static_front_page'); //固定フロントページ $wp_customize->remove_section('custom_css'); //追加CSS } add_action( 'customize_register', 'customize_register_custom_demo' ); } /* * スラッグ名が日本語だったら自動的に投稿タイプ＋id付与へ変更（スラッグを設定した場合は適用しない） */ function auto_post_slug( $slug, $post_ID, $post_status, $post_type ) { if ( preg_match( '/(%[0-9a-f]{2})+/', $slug ) ) { $slug = utf8_uri_encode( $post_type ) . '-' . $post_ID; } return $slug; } add_filter( 'wp_unique_post_slug', 'auto_post_slug', 10, 4 ); |
必要に応じて有効にするもの
- カスタムメニューの利用と登録(functions.phpとテンプレートファイルへの追加例)
- 親ページ/子ページ/孫ページをIDで指定する条件分岐
- body_classにページスラッグ名を含ませたりオリジナルのclassを追加
- 画像サイズ追加&管理画面から選べるようにカスタム
- アイキャッチ画像の利用とサイズ追加
- 一覧ページ等で、アイキャッチ画像がなかったら一番目の画像を取得し、さらに画像がなかったら定義した画像を表示
- phpファイルを読み込むショートコード
- ニュースカテゴリー(news)を読み込むショートコード
- カスタム投稿のパーマリンクをIDにする
- パスワード変更時にシステムからユーザーへ送られるメール本文を変更
※上記は参考であり、プラグイン利用を選択する場合もあり、また内容は随時変更されます
こんな記事も読まれています
WP REST APIのエンドポイントを無効にする
固定ページのみ自動的に付与されるpタグやbrタグを無効にしてレイアウト崩れを伏せぐ
自動で読み込まれる絵文字を読込むscriptとstyleを無効化する
WordPressに備えてあるjQueryを読み込まずに独自に設定し読み込むようにするこの記事を書いた人
池田祐太郎 
WordPress好きの池田です。Webの仕事の前はライブハウスでブッキングや音響をしてました。PHP, JavaScriptを自由に操りたいと思いつつ、つい訪れたサイトのソースコードを見てしまいます。
