AIにArkheのカスタマイズを頼むと、存在しないフック名や、SWELLの書き方が混ざった答えが返ってくることがあります。
Arkheはテーマ本体が無料で、機能の多くを専用プラグインに分けているため、どこに何があるかが見えにくいのが原因です。
そこで、Arkhe本体と関連プラグインを解析して、外から呼べる名前を全部一覧にしました。
この記事をそのままAIに渡せば、テーマとプラグインの輪郭を把握させられます。
| 種類 | 数 | どこにあるか |
|---|---|---|
| ブロック | 34種(無料で使えるのは26種) | Arkhe Blocks / Pro |
| アクションフック | 55種 | テーマ本体 |
| フィルターフック | 61種 | テーマ本体 |
| テーマ設定 | 71項目 | テーマ本体(カスタマイザー) |
| テンプレート部品 | 53個 | テーマ本体 |
| CSS変数 | 62種+57種 | テーマ本体+Arkhe Blocks |
| ユーティリティクラス | 58種 | テーマ本体 |
| 記事ごとの設定 | 12種 | Arkhe Toolkit |
| ショートコード | 6種 | Arkhe Toolkit |
最終調査日は2026年9月26日です。
数え方と、解析に使った版は記事の最後に書いています。
テーマやプラグインのソースコードは載せていません。
ここに並べたのは、外から呼ぶための名前だけです。
Arkheの製品構成と、無料・有料の境目
最初に、どれが無料でどれが有料かを整理します。
AIに頼むとき、入っていないプラグインの機能を前提にされるのがいちばん多い失敗だからです。
| 製品 | 最新版 | 入手方法 | 主な役割 |
|---|---|---|---|
| Arkhe(テーマ本体) | 3.14 | 無料・WordPress.org | レイアウト、カスタマイザー、フック |
| Arkhe Blocks | 2.27.1 | 無料・WordPress.org | ブロックの無料版 |
| Arkhe Blocks Pro | 2.30 | Pro Pack/買い切り | 全ブロック、カスタム書式、コアブロックの拡張 |
| Arkhe Toolkit | 1.11 | Pro Pack/買い切り | 高速化、ウィジェット追加、記事ごとの設定、コア機能の停止 |
| Arkhe CSS Editor | 1.2.2 | Pro Pack | 管理画面でCSSを編集 |
| Arkhe Wookit | 1.0(公式の更新情報) | 単体の買い切り | WooCommerceの見た目をArkheに合わせる |
Arkhe Pro Packは、Blocks Pro・Toolkit・CSS Editorの3つを年額で使える契約です。
公式ショップでは、個人ライセンスが年6,600円、制作ライセンスが年9,900円(いずれも税込)と案内されています。
Blocks ProとToolkitには買い切り版もあります。
買い切り版は購入した時点の版しか受け取れないので、あとから出た版を使うには契約か再購入が要ります。
Arkhe 3.14とBlocks Pro 2.30は、2026年8月20日にWordPress 7.1への対応として公開されました。
テーマ本体(Arkhe 3.14.0)
Arkhe本体は、見た目の装飾を最小限にして、差し込み口を多く用意する設計です。
アクションフックが55種あり、ヘッダーやフッターの内側まで細かく差し込めます。
フックの数は調査した版と数え方で変わります。テーマ間の数の比較だけでは、変更できる範囲は判断できません。
Arkheでは、「どこに何を出すか」をフックで足していく作り方に向いています。
テーマ設定(71項目)
カスタマイザーの項目の実体です。
値は arkhe_settings という1つのオプションに、まとめて保存されています。
| 群 | 項目数 | 主なキー |
|---|---|---|
| カラー | 5 | color_main、color_text、color_link、color_bg、color_gray |
| コンテンツ幅 | 2 | container_width、slim_width |
| 代替画像 | 1 | no_image |
| パンくずリスト | 3 | breadcrumbs_pos、breadcrumbs_home_text、breadcrumbs_set_home_page |
| スムーススクロール | 1 | smooth_scroll |
| ヘッダー | 19 | header_color_bg、header_color_txt、head_logo_overlay、header_overlay_on_page、color_text_overlay_header、logo_size_pc… |
| フッター | 4 | footer_color_bg、footer_color_txt、show_pagetop、copyright |
| サイドバー | 4 | show_sidebar_top、show_sidebar_page、show_sidebar_post、show_sidebar_archive |
| 投稿リスト | 10 | post_list_layout、excerpt_length、show_list_cat、show_list_date、show_list_mod、show_list_author… |
| 固定ページ設定 | 4 | page_title_pos、title_bg_filter、ttlbg_overlay_color、ttlbg_overlay_opacity |
| 投稿ページ | 7 | show_entry_posted、show_entry_modified、show_entry_cat、show_entry_tag、show_entry_custom_tax、show_entry_author… |
| 下部エリア | 11 | show_foot_terms、show_prev_next_link、show_author_box、show_comments、show_img_shadow、show_related_posts… |
読むときは Arkhe::get_setting( 'キー' ) を使います。
初期値は Arkhe::get_default_setting( 'キー' ) で取れます。
// メインカラーを読む
$main = Arkhe::get_setting( 'color_main' );
// 全部まとめて配列で受け取る
$all = Arkhe::get_setting();
// 表示中だけ値を上書きする(保存はされない)
Arkhe::overwrite_setting( 'show_sidebar_post', false );カスタマイザーのセクションは7つです。
| セクションID | 中身 |
|---|---|
arkhe_section_global | 全体(色・幅・パンくずなど) |
arkhe_section_header | ヘッダー |
arkhe_section_footer | フッター |
arkhe_section_sidebar | サイドバー |
arkhe_section_post_list | 投稿リスト(アーカイブ) |
arkhe_section_single | 投稿ページ |
arkhe_section_page | 固定ページ |
アクションフック(55種)
出る場所ごとに分けて並べます。
名前の規則は、要素の外側が before_ と after_、内側が start_ と end_ です。
ヘッダー(5種)
arkhe_after_headerarkhe_before_headerarkhe_header_bar_contentarkhe_header_left_contentarkhe_header_right_content
ドロワーメニュー(3種)
arkhe_after_drawer_navarkhe_end_drawer_bodyarkhe_start_drawer_body
サイドバー(2種)
arkhe_end_sidebararkhe_start_sidebar
フッター(7種)
arkhe_after_copyrightarkhe_after_footerarkhe_before_copyrightarkhe_before_footerarkhe_end_footer_innerarkhe_start_footer_foot_contentarkhe_start_footer_inner
コンテンツ全体(2種)
arkhe_end_contentarkhe_start_content
投稿ページ(8種)
arkhe_after_author_namearkhe_after_entry_contentarkhe_author_linksarkhe_before_entry_contentarkhe_end_entry_footarkhe_end_entry_mainarkhe_start_entry_footarkhe_start_entry_main
固定ページ(4種)
arkhe_after_page_contentarkhe_before_page_contentarkhe_end_page_mainarkhe_start_page_main
フロント・ブログページ(8種)
arkhe_after_front_contentarkhe_after_home_contentarkhe_before_front_contentarkhe_before_home_contentarkhe_end_front_mainarkhe_end_home_mainarkhe_start_front_mainarkhe_start_home_main
アーカイブ・検索・著者(10種)
arkhe_before_archive_post_listarkhe_before_author_post_listarkhe_before_search_post_listarkhe_before_term_post_listarkhe_end_archive_mainarkhe_end_author_mainarkhe_end_search_mainarkhe_start_archive_mainarkhe_start_author_mainarkhe_start_search_main
404ページ(4種)
arkhe_after_404_contentarkhe_before_404_contentarkhe_end_404_mainarkhe_start_404_main
テンプレート部品の前後(2種)
arkhe_did_get_part__{部品}arkhe_pre_get_part__{部品}
ヘッダー上部の細い帯は、arkhe_header_bar_content に何かを登録したときだけ現れます。
何も登録しなければ、帯そのものが出力されません。
// ヘッダーの上に、お知らせの帯を出す
add_action( 'arkhe_header_bar_content', function () {
echo '<p>年末年始の営業日のお知らせ</p>';
} );フィルターフック(61種)
値を書き換える口です。
用途ごとに分けて並べます。
テンプレート部品(4種)
arkhe_part__{部品}arkhe_part_args__{部品}arkhe_part_cache__{部品}arkhe_part_path__{部品}
表示する・しないの判定(12種)
arkhe_is_header_overlayarkhe_is_show_commentsarkhe_is_show_sidebararkhe_is_show_ttltoparkhe_show_author_boxarkhe_show_entry_thumbarkhe_show_foot_termsarkhe_show_prev_next_linkarkhe_show_related_postsarkhe_show_term_descriptionarkhe_use_fse_blocksarkhe_use_lazy_top_area
投稿リスト・関連記事(9種)
arkhe_list_layoutsarkhe_list_type_on_archivearkhe_list_type_on_authorarkhe_list_type_on_homearkhe_list_type_on_searcharkhe_list_type_on_termarkhe_move_post_count_into_aarkhe_related_area_titlearkhe_related_posts_args
タグの属性・class(6種)
arkhe_header_attrsarkhe_main_body_attrsarkhe_main_body_classarkhe_main_classarkhe_post_content_classarkhe_root_attrs
ロゴ・画像(8種)
ark_get__head_logo_imgark_the__thumbnailarkhe_get_svgarkhe_head_logo_overlay_urlarkhe_head_logo_sizesarkhe_head_logo_urlarkhe_logo_tagarkhe_ttlbg_img_id
見出し・文言(9種)
ark_the__taglinearkhe_404_contentarkhe_404_titlearkhe_author_area_titlearkhe_no_posts_textarkhe_page_subtitlearkhe_search_titlearkhe_term_descriptionarkhe_top_area_excerpt
差し替えできる関数の出力(3種)
ark_get__term_linksark_the__pnlinkark_the__postdate
取得するデータ(6種)
arkhe_breadcrumbs_dataarkhe_breadcrumbs_positionarkhe_get_archive_dataarkhe_get_author_icon_dataarkhe_get_tax_of_post_typearkhe_get_the_terms_data
その他(4種)
arkhe_alignwide_plus_widtharkhe_content_widtharkhe_customizer_argsarkhe_gnav_location_name
一つずつの引数とサンプルコードは、Arkhe│アクションフック・フィルターフック全まとめにまとめています。
サイドバーの有無を変えるときは、1点だけ注意があります。
固定ページで「1カラム」「2カラム」のテンプレートを選んでいると、arkhe_is_show_sidebar を通らずに決まります。
フィルターが効かないときは、テンプレートの指定を先に確かめてください。
// お問い合わせページだけサイドバーを消す
add_filter( 'arkhe_is_show_sidebar', function ( $show ) {
if ( is_page( 'contact' ) ) {
return false;
}
return $show;
} );テンプレート部品(53個)
Arkheは get_template_part() ではなく、独自の Arkhe::get_part() で部品を読み込みます。
そのため、部品ごとに6種類のフックが自動で用意されます。
| フック | 種類 | できること |
|---|---|---|
arkhe_pre_get_part__{部品} | アクション | 部品の直前に出力を足す |
arkhe_part_args__{部品} | フィルター | 部品に渡す引数を書き換える |
arkhe_part_path__{部品} | フィルター | 読み込むファイルを差し替える |
arkhe_part_cache__{部品} | フィルター | キャッシュ済みのHTMLを返して読み込みを省く |
arkhe_part__{部品} | フィルター | 出力されたHTMLを書き換える |
arkhe_did_get_part__{部品} | アクション | 部品の直後に出力を足す |
表の {部品} には single/foot/related_posts のように、template-parts/ からの場所を拡張子なしで入れます。
Arkhe Toolkitの「パーツキャッシュ」は、この arkhe_part_cache__ を使っています。
// 関連記事の直前に見出しを足す
add_action( 'arkhe_pre_get_part__single/foot/related_posts', function () {
echo '<p class="u-fz-s">あわせて読みたい</p>';
} );
// 部品のHTMLを書き換える
add_filter( 'arkhe_part__other/breadcrumb', function ( $html, $args ) {
return str_replace( 'Home', 'ホーム', $html );
}, 10, 2 );ファイルで差し替えるなら、子テーマの template-parts/ に同じ名前で置きます。
探す順番は、子テーマ、プラグインが指定した場所、親テーマの順です。
| 場所 | 部品 |
|---|---|
archive/ | archive、archive/title |
archive_term/ | archive_term |
footer/ | footer、footer/fix_btns、footer/modals |
front/ | front |
header/ | header、header/btn/drawer、header/btn/search、header/drawer_menu、header/gnav、header/header_bar、header/logo、header/logo/image、header/logo/text |
home/ | home |
other/ | other/author_box、other/breadcrumb、other/pagination |
page/ | page、page/head、page/title |
post_list/ | post_list/item/meta、post_list/item/meta/author、post_list/item/meta/category、post_list/item/meta/times、post_list/item/thumb、post_list/main_query、post_list/style/normal、post_list/style/related、post_list/style/simple、post_list/sub_query |
sidebar/ | sidebar |
single/ | single、single/foot、single/foot/meta、single/foot/post_author、single/foot/prev_next_link、single/foot/related_posts、single/head、single/head/meta、single/head/thumbnail、single/head/title、single/item/post_author、single/item/prev_next_link、single/item/related_posts、single/item/term_list、single/item/thumbnail |
top_area/ | top_area、top_area/other、top_area/singular、top_area/term |
差し替えできる関数(6つ)
次の関数は function_exists で包まれています。
子テーマの functions.php で同じ名前の関数を先に定義すると、テーマ側のものと入れ替わります。
| 関数 | 出すもの |
|---|---|
ark_get__head_logo_img | ヘッダーのロゴ画像 |
ark_the__tagline | キャッチフレーズ |
ark_the__thumbnail | アイキャッチ画像 |
ark_the__postdate | 投稿日・更新日 |
ark_the__pnlink | 前後の記事へのリンク |
ark_get__submenu_toggle_btn | サブメニューの開閉ボタン |
関数ごと差し替えるより、同じ名前のフィルターで出力を書き換えるほうが、テーマの更新に強くなります。
テーマのクラスで使えるメソッド
すべて Arkhe:: から呼べます。
自作のコードでよく使うものだけ並べます。
| メソッド | 用途 |
|---|---|
get_setting( $key ) | テーマ設定を読む |
get_part( $slug, $args ) | テンプレート部品を読み込む |
get_svg( $name ) / the_svg( $name ) | テーマ内蔵のアイコンを出す |
get_image( $id, $args ) | 遅延読み込みに対応した画像タグを作る |
is_show_sidebar() | サイドバーを出すページか |
is_header_overlay() | ヘッダーを重ねて表示しているか |
is_show_ttltop() | タイトルをコンテンツの上に出しているか |
get_breadcrumbs_position() | パンくずの位置 |
get_lazy_type() | 遅延読み込みの方式 |
is_use( $key ) | そのページで使われている機能か |
ページテンプレート・メニュー位置・ウィジェットエリア
| 種類 | 名前 | 中身 |
|---|---|---|
| ページテンプレート | templates/one-column-slim.php | 1カラム(スリム幅) |
| ページテンプレート | templates/one-column.php | 1カラム |
| ページテンプレート | templates/two-column.php | 2カラム |
| メニュー位置 | header_menu | グローバルナビ |
| メニュー位置 | drawer_menu | ドロワーメニュー |
| メニュー位置 | footer_menu | フッター |
| ウィジェット | sidebar-1 | サイドバー |
| ウィジェット | drawer-bottom | ドロワーメニューの下 |
| ウィジェット | footer-1、footer-2 | フッター(2列) |
CSS変数(62種)
接頭辞は --ark- です。
色や幅はカスタマイザーの値がこの変数に入るので、CSSで上書きするときの鍵になります。
| 変数 | 中身 |
|---|---|
--ark-color_main | メインカラー |
--ark-color_text | 文字色 |
--ark-color_link | リンク色 |
--ark-color_bg | 背景色 |
--ark-color_gray | 薄い灰色 |
--ark-container_width | サイトの幅 |
--ark-slim_width | スリム幅 |
--ark-header_height | ヘッダーの高さ |
--ark-width--sidebar | サイドバーの幅 |
--ark-padding--container | 左右の余白 |
--ark-font_size | 本文の文字サイズ |
--ark-line_height | 本文の行間 |
--ark-mt | ブロックの間の余白 |
--ark-fz--s | 小さい文字 |
--ark-fz--l | 大きい文字 |
--ark-drawerW | ドロワーメニューの幅 |
全部の名前は次のとおりです。
--ark-searchW、--ark-adminbar_height、--ark-color--border、--ark-height--full、--ark-mediatext--gap、--ark-mediatext--offsetX、--ark-mediatext--offsetY、--ark-mediatext--space、--ark-mt--inner、--ark-nav-padding--L、--ark-100vh、--ark-alignwide_ex_width、--ark-menulist_border、--ark-nav-padding--R、--ark-nav-padding--Y、--ark-nav_fz、--ark-gap--container、--ark-width--article、--ark-color--header_bg、--ark-color--header_txt、--ark-editor-100vw、--ark-article_width、--ark-color--border--table、--ark-color--gray--hover、--ark-color--link、--ark-color_border、--ark-font_family、--ark-fz--huge、--ark-fz--m、--ark-fz--n、--ark-fz--xl、--ark-fz--xs、--ark-fz--xxl、--ark-header_height--fixed、--ark-hover_gray、--ark-letter_spacing、--ark-list-padding、--ark-list-padding--has_bg、--ark-mt--h、--ark-mt--s、--ark-offset--y、--ark-opacity--thin、--ark-pad--container、--ark-scrollbar_width、--ark-submenu_btn_size、--ark-guide-offset
画面の区切りは、1000px以上がPC、600px以上1000px未満がタブレット、600px未満がスマートフォンです。
ユーティリティクラス(58種)
ブロックの「追加CSSクラス」に書くだけで効くクラスです。
CSSを書かずに、表示の切り替えや余白の調整ができます。
| 用途 | クラス |
|---|---|
| 表示の切り替え | u-display-block、u-display-none、u-hide-pc、u-hide-sp、u-only-pc、u-only-sp |
| 余白 | u-mb-0、u-mb-10、u-mb-15、u-mb-20、u-mb-25、u-mb-30、u-mb-40、u-mb-5、u-mb-50、u-mb-60、u-mb-80、u-mt-0、u-mt-10、u-mt-15、u-mt-20、u-mt-25、u-mt-30、u-mt-40、u-mt-5、u-mt-50、u-mt-60、u-mt-80 |
| 文字 | u-color-thin、u-fw-bold、u-fw-lighter、u-fw-normal、u-fz-l、u-fz-m、u-fz-n、u-fz-s、u-fz-xl、u-fz-xs、u-fz-xxl、u-lh-10、u-lh-12、u-lh-14、u-lh-15、u-lh-16、u-lh-18、u-lh-20、u-ta-c、u-ta-l、u-ta-r |
| その他 | u-cf、u-cf--after、u-flex、u-flex--aic、u-flex--aicw、u-flex--c、u-fullheight、u-obf-contain、u-obf-cover |
Arkhe Blocks と Arkhe Blocks Pro
ブロックは、テーマ本体ではなくこのプラグインが追加します。
接頭辞はすべて arkhe-blocks/ です。
無料版のコードには、Pro版だけのブロックも含めて34種の名前が並んでいます。
Pro版でないと登録されないものと、テーマがArkheでないと登録されないものに、印が付いています。
ブロック一覧(34種)
| ブロック名 | 表示名 | 使える条件 |
|---|---|---|
arkhe-blocks/accordion | アコーディオン | 無料版から |
arkhe-blocks/accordion-item | アコーディオンの項目 | 無料版から |
arkhe-blocks/blog-card | ブログカード | 無料版から |
arkhe-blocks/box-links | ボックスリンク | Pro版 |
arkhe-blocks/box-link | ボックスリンクの項目 | Pro版 |
arkhe-blocks/buttons | ボタン(まとめ) | 無料版から |
arkhe-blocks/button | ボタン | 無料版から |
arkhe-blocks/columns | リッチカラム | 無料版から |
arkhe-blocks/column | カラム | 無料版から |
arkhe-blocks/container | コンテナ | 無料版から |
arkhe-blocks/custom-code | カスタムコード | 無料版から |
arkhe-blocks/faq | Q&A | 無料版から |
arkhe-blocks/faq-item | Q&Aの項目 | 無料版から |
arkhe-blocks/dl | 説明リスト | 無料版から |
arkhe-blocks/dl-dt | 用語 | 無料版から |
arkhe-blocks/dl-dd | 説明 | 無料版から |
arkhe-blocks/dl-div | 横並びの組 | 無料版から |
arkhe-blocks/icon | アイコン | 無料版から |
arkhe-blocks/notice | 通知 | 無料版から |
arkhe-blocks/section | セクション | 無料版から |
arkhe-blocks/section-heading | セクション見出し | 無料版から |
arkhe-blocks/step | ステップ | 無料版から |
arkhe-blocks/step-item | ステップの項目 | 無料版から |
arkhe-blocks/tab | タブ | 無料版から |
arkhe-blocks/tab-body | タブの中身 | 無料版から |
arkhe-blocks/timeline | タイムライン | 無料版から |
arkhe-blocks/timeline-item | タイムラインの項目 | 無料版から |
arkhe-blocks/toc | 目次 | 無料版から |
arkhe-blocks/slider | スライダー | Pro版 |
arkhe-blocks/slider-item | スライド | Pro版 |
arkhe-blocks/restricted-area | 制限エリア | Pro版 |
arkhe-blocks/page-list | 固定ページリスト | Pro版+テーマがArkhe |
arkhe-blocks/post-list | 投稿リスト | Pro版+テーマがArkhe |
arkhe-blocks/rss | RSS | Pro版+テーマがArkhe |
無料版で使えるブロックにも、一部の設定がPro版だけのものがあります。
公式の比較表では、通知・セクション・タブ・ステップ・タイムライン・ブログカード・リッチカラムがそれに当たります。
親の中でしか使えないブロック
次の組み合わせは、親ブロックの中にしか置けません。
AIに書かせるときは、この親子関係を先に渡さないと入れ子が壊れます。
| 親 | 中に入れるもの |
|---|---|
arkhe-blocks/accordion | arkhe-blocks/accordion-item |
arkhe-blocks/buttons | arkhe-blocks/button |
arkhe-blocks/columns | arkhe-blocks/column |
arkhe-blocks/dl | arkhe-blocks/dl-dt、arkhe-blocks/dl-dd、arkhe-blocks/dl-div |
arkhe-blocks/dl-div | arkhe-blocks/dl-dt、arkhe-blocks/dl-dd |
arkhe-blocks/faq | arkhe-blocks/faq-item |
arkhe-blocks/step | arkhe-blocks/step-item |
arkhe-blocks/tab | arkhe-blocks/tab-body |
arkhe-blocks/timeline | arkhe-blocks/timeline-item |
arkhe-blocks/box-links | arkhe-blocks/box-link |
arkhe-blocks/slider | arkhe-blocks/slider-item |
Q&Aの項目の block.json は、親の欄が自分自身(arkhe-blocks/faq-item)になっています。
機械的に親を読み取ると取り違えるので、arkhe-blocks/faq の中に置くと覚えておいてください。
コアブロックに足されるスタイル
WordPress標準のブロックにも、スタイルが追加されます。
ブロックの「スタイル」欄から選べ、クラス名は is-style- に続く名前です。
| ブロック | スタイル名 |
|---|---|
core/image、core/video | ark-media-shadow、ark-media-border、ark-media-frame(影・枠線・フレーム) |
core/list | ark-list-icon--dot、ark-list-icon--caret、ark-list-icon--check、ark-list-icon--circle、ark-list-icon--triangle、ark-list-icon--x、ark-list-icon--question、ark-list-numbered、ark-list-note |
core/media-text | ark-card(カード型) |
core/quote | large(大きい引用) |
Pro版では、コアブロックのツールバーに「ブロックの上の余白」を決めるボタンも足されます。
こちらはテーマがArkheのときだけ使えます。
カスタム書式(Pro版)
文字の一部に付ける書式です。
ツールバーからまとめて呼び出せます。
| 書式の名前 | 中身 |
|---|---|
arkhe-blocks/marker | マーカー |
arkhe-blocks/font-size | 文字サイズ |
arkhe-blocks/letter-spacing | 字間 |
arkhe-blocks/inline-icon | 文中のアイコン |
arkhe-blocks/mini-note | 注釈 |
arkhe-blocks/clear | 書式の解除 |
arkhe-blocks/custom-{スラッグ} | 設定画面で自分で作った書式 |
フィルターと設定の保存先
arkb_blogcard__cache_timearkb_blogcard__excerpt_lengtharkb_blogcard__name_lengtharkb_blogcard__title_lengtharkb_scroll_hintarkb_section__media_htmlarkb_toc__ignore_classesarkhe_blocks_custom_formatsarkhe_blocks_part__{パス}arkhe_blocks_part_path__{パス}
ブログカードの文字数やキャッシュ時間、目次から外すクラスなどを変えられます。
Pro版には、ボックスリンク・スライダー・RSSのフックも加わります。
| 保存先(オプション名) | 中身 |
|---|---|
arkhe_blocks_general | 全般(コア拡張・書式の停止、パレットの色など) |
arkhe_blocks_format | 書式(マーカーの色や形、カスタム書式) |
arkhe_blocks_block | ブロック(目次の見出し階層、ボタンの既定の色など) |
arkhe_licence_key | ライセンスキー(テーマ本体と共通) |
設定の書き出しと読み込みは、REST APIの wp/v2/arkhe-blocks-settings-export、wp/v2/arkhe-blocks-settings-import、wp/v2/arkhe-blocks-settings-import-check で行われています。
CSS変数は --arkb- で始まり、57種あります。
余白・カラム幅・ボタンの角丸などを、ブロックの外から上書きできます。
Arkhe Toolkit
テーマ本体に入っていない、サイト運営向けの機能をまとめたプラグインです。
最新版は1.11です。
機能は、公式の機能説明と更新情報をもとに整理しています。
表の「追加された版」が空欄のものは、早い版からある機能です。
| 機能 | 中身 | 追加された版 |
|---|---|---|
| パーツキャッシュ | ヘッダー・フッター・サイドバーのHTMLを保存して使い回す | |
| ドロワーメニュー | 開き方を選べる | |
| シェアボタン | 表示位置とSNSの種類を選べる | |
| ウィジェットエリアの追加 | 記事の上下、固定ページの上下、ブログページの上下、追尾サイドバー | |
| フッター前ウィジェット | フッターの直前に置ける | 1.8 |
| 画像の拡大表示 | クリックで画像を拡大 | |
| 遅延読み込み | 画像・動画・iframe | 設定は1.6 |
| スクリプトの遅延読み込み | 指定したJSを後から読む | 1.7 |
| ページ遷移の高速化 | リンク先を先読みする | 1.11で調整 |
| 空のpタグの除去 | 本文の空段落を消す | |
| 構造化データ | 記事とパンくずのJSON-LDを出す | |
| 記事ごとのコード | head内と、body閉じタグ前 | 1.8 |
| コア機能の停止 | 12項目(下の表) |
ショートコード(6種)
| ショートコード | 出すもの | 追加された版 |
|---|---|---|
[[reuse_block id="100"]] | 再利用ブロック(パターン) | |
[pcbr]、[spbr] | PCだけ・スマホだけの改行 | |
[icon class="…"] | アイコンの <i> タグ | |
[[ark_svg アイコン名]] | テーマとToolkitのSVGアイコン | 1.7 |
[html]] ~ [[/html] | 中身をHTMLとして出す | 1.9 |
記事ごとの設定(12種)
投稿・固定ページ・カテゴリーやタグの編集画面に、Arkheの設定欄が足されます。
保存先のメタキーは ark_meta_ で始まります。
| メタキー | 中身 |
|---|---|
ark_meta_show_thumb | アイキャッチを出すか |
ark_meta_show_author | 著者情報を出すか |
ark_meta_show_related | 関連記事を出すか |
ark_meta_show_sidebar | サイドバーを出すか(ターム) |
ark_meta_hide_widget_top | 上部ウィジェットを隠すか |
ark_meta_hide_widget_bottom | 下部ウィジェットを隠すか |
ark_meta_subttl | サブタイトル(固定ページ) |
ark_meta_ttlbg | タイトルの背景画像(固定ページ) |
ark_meta_ttlpos | タイトルの位置(固定ページ) |
ark_meta_show_excerpt | 抜粋を出すか(固定ページ) |
ark_meta_show_desc | 説明を出すか(ターム) |
ark_meta_list_type | 投稿リストの型(ターム) |
1.7でシェアボタンを隠す項目が、1.8で記事ごとのコード欄が加わっています。
1.8以降は、カスタム投稿タイプにもこの設定欄が出ます。
停止できるWordPressの機能(12項目)
| 止めるもの | 初期値 |
|---|---|
| WordPressのバージョン表記 | 停止 |
| 絵文字用のスクリプト | 停止 |
| コアのブロックパターン | 動く |
| rel=prev/next の出力 | 動く |
| Windows Live Writer 連携 | 動く |
| EditURI(RSD) | 動く |
| セルフピンバック | 動く |
| コアのサイトマップ | 動く |
| REST API の link タグ | 動く |
| srcset の出力 | 動く |
| 記号の自動変換(wptexturize) | 動く |
| RSSフィードのリンク | 動く |
フックと保存先
Toolkitのフックは arkhe_toolkit_ で始まります。
一つずつの名前と使い方は、Arkhe│アクションフック・フィルターフック全まとめに載せています。
1.8で arkhe_toolkit_side_meta_screens と arkhe_toolkit_code_meta_screens が加わり、設定欄を出す投稿タイプを変えられるようになりました。
1.9では、一部のフック名の綴りが arkhe_toolit_ から arkhe_toolkit_ に直されています。
古い名前で書いたコードは、更新後に効かなくなるので確かめてください。
| 保存先(オプション名) | 中身 |
|---|---|
arkhe_toolkit_customizer | カスタマイザーに足された項目 |
arkhe_toolkit_extension | 拡張機能のオン・オフ |
arkhe_toolkit_cache | パーツキャッシュ |
arkhe_toolkit_code | サイト全体のコード |
arkhe_toolkit_remove | 停止する機能 |
Arkhe CSS Editor
管理画面でCSSを書けるようにするプラグインです。
CSSは、フロントだけ・エディターだけ・両方の3か所に分けて書けます。
当方は、このプラグインをSWELLのサイトでも使っています。
テーマがArkheでなくても動きます。
| 保存先(オプション名) | 中身 | REST API |
|---|---|---|
arkhe_css_common | 両方で読むCSS | 読み書きできる |
arkhe_css_front | フロントだけで読むCSS | 読み書きできる |
arkhe_css_editor | エディターだけで読むCSS | 読み書きできる |
arkhe_css_settings | エディターの設定 | 読み書きできる |
arkhe_css_options | その他の設定 | 読み書きできる |
CSSの3つは /wp-json/wp/v2/settings に出ているので、管理画面を開かずに書き換えられます。
全文を上書きする形なので、取得してから追記して送ってください。
記事ごとのCSSは、メタキー arkhe_css_editor_meta に入ります。
カスタム投稿タイプにも欄を出すには arkhe_css_editor_meta_screen を使います。
// 「お知らせ」の投稿タイプにも、記事ごとのCSS欄を出す
add_filter( 'arkhe_css_editor_meta_screen', function ( $screens ) {
$screens[] = 'news';
return $screens;
} );1.2でツールバーにCSS Editorへのリンクが付き、1.2.2からはライセンス認証なしで管理画面から更新できるようになりました。
Arkhe Wookit
WooCommerceの商品ページやブロックの見た目を、Arkheに合わせるプラグインです。
Pro Packには含まれず、単体の買い切りで販売されています。
ここは公式の説明をもとに整理しています。
| 種類 | 名前 | 中身 |
|---|---|---|
| ウィジェットエリア | WooCommerce専用サイドバー | ショップのページだけに出すサイドバー |
| フィルター | arkhe_wookit_add_to_cart_text | カートに入れるボタンの文言 |
| CSS変数 | --ark-woo-color--price | 価格の色 |
| CSS変数 | --ark-woo-color--price--sale | セール価格の色 |
| CSS変数 | --ark-woo-color--star | レビューの星の色 |
| CSS変数 | --ark-woo-onsale--bg | 「セール」表示の背景色 |
| CSS変数 | --ark-woo-btn-primary--bg | 重要なボタンの背景色 |
| CSS変数 | --ark-woo-btn--padding | ボタンの内側の余白 |
| CSS変数 | --ark-woo-fz--grid | 商品一覧の文字サイズ |
| CSS変数 | --ark-woo-fz--grid_product | 商品リスト系ブロックの文字サイズ |
| CSS変数 | --ark-woo-mb--items | 商品リスト系ブロックの項目の間隔 |
SWELLと比べたときの違い
同じ作者のテーマなので、AIが2つを混同しやすくなっています。
違いが大きいところだけ並べます。
| 項目 | Arkhe | SWELL |
|---|---|---|
| ブロックの接頭辞 | arkhe-blocks/ | loos/ |
| ブロックの置き場所 | 別のプラグイン | テーマ本体 |
| アクションフック | 55種 | 4種 |
| テーマ設定 | 71項目 | 538項目 |
| 設定の読み出し | Arkhe::get_setting() | SWELL_Theme::get_setting() |
| 部品の読み込み | Arkhe::get_part() | SWELL_Theme::get_parts() |
| CSS変数の接頭辞 | --ark-、--arkb- | --swl- |
| 記事ごとの設定 | ark_meta_(Toolkit) | swell_meta_ |
SWELLの一覧は、SWELL│テーマ全機能リファレンスにまとめています。
AIに渡すときの書き方
そのまま貼るより、入っているプラグインと、何をしたいかを一緒に渡すほうが外しません。
当方が使っている頼み方です。
前提:WordPressテーマ Arkhe 3.14(SWELLではない)
入っているプラグイン:Arkhe Blocks Pro / Arkhe Toolkit / Arkhe CSS Editor
※入っていないものは前提にしないこと
ブロックの接頭辞は arkhe-blocks/ (例:arkhe-blocks/notice, arkhe-blocks/step)
親子のあるブロック:
arkhe-blocks/accordion → arkhe-blocks/accordion-item
arkhe-blocks/buttons → arkhe-blocks/button
arkhe-blocks/columns → arkhe-blocks/column
arkhe-blocks/dl → arkhe-blocks/dl-dt, arkhe-blocks/dl-dd, arkhe-blocks/dl-div
arkhe-blocks/faq → arkhe-blocks/faq-item
arkhe-blocks/step → arkhe-blocks/step-item
arkhe-blocks/tab → arkhe-blocks/tab-body
arkhe-blocks/timeline → arkhe-blocks/timeline-item
arkhe-blocks/box-links → arkhe-blocks/box-link
arkhe-blocks/slider → arkhe-blocks/slider-item
設定の読み出し:Arkhe::get_setting( 'キー' )
部品の読み込み:Arkhe::get_part( 'single/foot/related_posts' )
部品ごとのフック:arkhe_pre_get_part__{部品} / arkhe_part_path__{部品} / arkhe_part__{部品}
フックの接頭辞:arkhe_ (Toolkitは arkhe_toolkit_、Blocksは arkb_)
CSS変数:--ark-(テーマ)、--arkb-(ブロック)
やりたいこと:(ここに書く)「SWELLではない」と書いておくのが効きます。
書かないと、loos/ のブロックや swell_ のフックが混ざって返ってきます。
この記事の数え方
無料で配布されているものは、配布ファイルを展開して機械で数えました。
有料のプラグインは、公式サイトの機能説明と更新情報をもとに整理しています。
| 製品 | 版 | もとにしたもの |
|---|---|---|
| Arkhe | 3.14.0 | WordPress.org の配布ファイル |
| Arkhe Blocks | 2.27.1 | WordPress.org の配布ファイル |
| Arkhe Blocks Pro | 2.30 | 公式の機能説明と更新情報 |
| Arkhe Toolkit | 1.11 | 公式の機能説明と更新情報 |
| Arkhe CSS Editor | 1.2.2 | 公式の機能説明と更新情報、当方での運用 |
| Arkhe Wookit | — | 公式の機能説明 |
- フックは
do_actionとapply_filtersの呼び出しから数えました。部品ごとに名前が変わるものは、1種として数えています - 同梱の更新確認ライブラリのフックは除いています(テーマの機能ではないため)
- テーマ設定は、初期値の一覧にある項目を数えました
- ブロックは、Arkhe Blocksの中にあるブロックの一覧から数えました。Pro版だけのものも含みます
- WordPress本体のフックを、テーマが呼び直しているものは数えていません
フックの数は、数え方によって変わります。
部品ごとのフックを部品の数だけ数えると、何百にもなります。
バージョンが上がると増減しますので、使うときはお手元の版を確かめてください。
まとめ
Arkheは、テーマ本体にアクションフックが55種あり、差し込み口の多いテーマです。
ブロックはArkhe Blocks、運営向けの機能はToolkitと、機能がプラグインに分かれています。
AIに書かせるときは、入っているプラグインと、ブロックの親子関係を先に渡すと外しません。
フックを一つずつ使うときは、Arkhe│アクションフック・フィルターフック全まとめもあわせてご覧ください。
この記事で紹介しているコードは、GitHubのMOTOKI-LLC/WAZA-codeにもまとめています。
設定の上書きを試す例
次のPHPはArkheの子テーマのfunctions.phpのPHP領域、またはCode SnippetsのPHPスニペットのどちらか一方へ追加します。通常投稿の個別ページだけでサイドバー設定を変更します。親テーマへは書きません。既存の設定値をデータベースへ保存する処理ではありません。
add_action( 'wp', function () {
if ( ! class_exists( 'Arkhe' ) || ! is_singular( 'post' ) ) {
return;
}
// 設定を読み込んでから、このリクエストだけ変更する。
Arkhe::get_setting();
Arkhe::overwrite_setting( 'show_sidebar_post', false );
} );公式配布テーマのget_setting・overwrite_settingを照合した例です。実サイトへの適用前に検証環境で通常投稿・固定ページ・一覧をPCとスマホで確認してください。記事ごとの設定や関連プラグインが表示に影響する場合があります。元に戻すときは追加した処理を削除するか、該当スニペットを無効にします。全プラグイン構成での表示確認は未実施です。



