Hima Art Utilityプラグインを有効化すると使えるようになるショートコードの一覧ページです。
ここに掲載しているショートコードは、投稿エディターのブロックツールバーまたはパターンから呼び出すことができますので、1つ1つのショートコードを覚えていただく必要はありません。
ブロックツールバーからショートコードを挿入する場合は以下の手順で行ってください。
- 段落ブロックを挿入する
- 何か文字を入れる
- ブロックの上に表示されるアイコンをクリックしてショートコードを選択
- 2で入力した文字を削除する
コンテンツ追加ショートコード
特殊な表現や機能を持つコンテンツを追加するためのショートコードです
このショートコードは「コンテンツ追加」ブロックパターンから挿入できます
ショートコードの間に入れたコンテンツ全体をリンクにし、クリック可能にします。
[ha-cover-link url="https://example.com" target="_blank"]
[/ha-cover-link]
このショートコードはブロックツールバーから挿入できます
アイコンブロックのSVG画像をインラインで挿入できるようにするショートコードです。
詳しくは以下のページをご覧ください。
「保護コンテンツ」投稿タイプで作成したコンテンツをパスワード付きで表示します
サイト内の投稿や固定ページをフリーワードで検索できるフォームを表示させるショートコードです
このショートコードはブロックツールバーから挿入できます
予め設定しておいた簡易説明文を、文字列をマウスオーバーした際にポップアップ(吹き出し風)表示させる機能です。
サンプルです。こちらを→マウスオーバー説明文説明文説明文説明文説明文説明文←すると、「説明文..」という吹き出しが表示されます。
[ha-tooltip title="タイトルを入力" text="説明を入力"]
| パラメーター | 説明 |
|---|---|
| title | マウスオーバーの対象となる文字列を指定します |
| text | マウスオーバーされた時に吹き出し式のコンテンツへ表示される説明文などを指定します |
title、textパラメーターとも、brタグなどのHTMLタグは使用できません(使用すると不具合が起きて表示に支障が出ます)
ツールチップ(ポップアップ)部分の各色は、「追加コンテンツ」設定メニューから指定できます。
| 色の種類 | 色が適用される部分 | デフォルト |
|---|---|---|
| 文字色 | ポップアップ内の文字色と、対象テキストの下線色 | #222 |
| 背景色 | ポップアップの背景色 | #eee |
| 枠線色 | ポップアップの枠線と吹き出し部分の色 | #777 |
このショートコードは「コンテンツ追加」ブロックパターンから挿入できます
ショートコード内に追加したブロックの内容をポップアップ表示します
「ポップアップ」メニューから作成したコンテンツをポップアップ表示させるショートコードです
このショートコードは「テーマ向け」ブロックパターンから挿入できます
ページ内に広告が含まれることを告知するためのショートコードです
データの出力ショートコード
サイトに保存されているデータを表示させるためのショートコードです
このショートコードはブロックツールバーから挿入できます
投稿・固定ページに保存されているカスタムフィールドの値を出力します。
またパラメーターで投稿IDを指定することで、現在の投稿・固定ページ以外の情報も表示させることができます。
ショートコード
[ha-field field='' post_id='' wrap='']
| パラメーター | 内容 |
|---|---|
| field | カスタムフィールド名(ID) |
| post_id | 投稿・固定ページのID ※現在の投稿・固定ページを指定する場合は空白 |
| wrap | フィールド値を出力するHTMLタグ ※未指定またはパラメーターがない場合はspanタグで囲まれます |
※wrapパラメーターは、バージョン2.1以降で使用可能です
このショートコードはブロックツールバーから挿入できます
パターンのIDを指定して、特定のパターンの内容を表示できます。
[ha-reuse-sc id=""]
IDパラメーターにパターンのIDを指定します
最終更新日から一定期間経過した投稿へ情報が古い可能性があることを表示します
閲覧制限
ショートコード内に含めたブロックを様々な条件で表示させるショートコードです
このショートコードはブロックツールバーから挿入できます
ショートコード内に挿入されたブロックをログインしているユーザーだけに表示させることができるショートコードです。
[if-login]
ログインユーザーのみに表示するブロック
[/if-login]
このショートコードはブロックツールバーから挿入できます
ショートコード内に挿入されたブロックをモバイル環境で閲覧時のみ表示させることができるショートコードです。
タブレット端末はパソコンとして認識されますので、本ショートコードで囲んだコンテンツは非表示になります
[ha-mobile]
モバイルのみ表示させるブロック
[/ha-mobile]
このショートコードは「閲覧制限」ブロックパターンから挿入できます
特定の投稿タイプでのみショートコードで囲まれたコンテンツを表示します
[ha-ptype posttype=""]
特定の投稿タイプで表示するブロック
[/ha-ptype]
posttypeパラメーターに適用する投稿タイプのスラグを指定します
このショートコードはブロックツールバーから挿入できます
ショートコード内に挿入されたブロックを管理者権限でログインしているユーザーだけに表示させることができるショートコードです。
[if-admin]
管理者権限でログインしているユーザーのみに表示するブロック
[/if-admin]
このショートコードはブロックツールバーから挿入できます
ショートコード内に挿入されたブロックをパソコン環境で閲覧時のみ表示させることができるショートコードです。
タブレット端末はパソコンとして認識されます
[ha-pc]
モバイルのみ表示させるブロック
[/ha-pc]
日付と時刻
日付と時刻を表示させるためのショートコードです
このショートコードはブロックツールバーから挿入できます
投稿や固定ページの最終更新日を表示します。文章などの途中に入れても機能します。
使用例
編集画面の入力
最終更新日は[ha-mdate]です
訪問者へ表示される内容
最終更新日はです
日付形式はサイト設定に従います
ショートコード
[ha-mdate]
このショートコードはブロックツールバーから挿入できます
誕生日から現在までの経過年月数(年齢)を表示します。
没(死亡)年齢が指定されている場合は、没日と没年齢を表示します。
[ha-calculate-age birthday="" dead_day="" show_birthday="" show_months=""]
以下が各パラメーターの設定内容と効果です。
| パラメーター | 説明 | 未設定の場合の値 |
|---|---|---|
| birthday | 誕生日をyyyymmddで入力します | 何も表示しません |
| dead_day | 没日をyyyymmddで入力します | 入力されていれば没日と没年齢を表示します |
| show_birthday | 「no」と指定すると誕生日を表示せず年齢のみを表示します | yes |
| show_months | 「no」と指定すると「〇カ月」を表示せず歳のみを表示します | yes |
このショートコードはブロックツールバーから挿入できます
投稿・固定ページの公開日・最終更新日を和暦を含めて表示します
本ページのタイトル下で実際に表示しています
公開日ショートコード
[p-wareki]
更新日ショートコード
[m-wareki]
和暦以外の日付部分は、サイトの日付フォーマットに従った形で表示されます
テーマ向け
主にテーマテンプレートの中で使用するショートコードです
このショートコードは「テーマ向け」ブロックパターンから挿入できます
CSSのみで構成した、軽量な画像スライダーです。
ゆっくりと拡大する画像を表示しながら、おおよそ6秒程度で次の画像へ移り変わっていきます。
プラグイン設定画面で3枚の画像を選択し、背景画像の高さ、全幅(画面いっぱいに表示するか)を設定した上で以下のショートコードを挿入します。
[ha-slide-image]
画像の高さを設定しない場合には500pxがセットされます
画像は、幅や高さを調整した上でcover(余白を埋める)処理して表示させます。サイト幅、スライダーの高さに合わせた画像をアップロードすることで、挿入した画像そのものに近い形で表示させることができます。
このショートコードは「テーマ向け」ブロックパターンから挿入できます
フッターに、サイト名(トップページへのリンク)、サイト著作権の範囲(投稿コンテンツの日付範囲を年に直したもの)を表示します。
本ページのフッターに表示させています
ショートコード
[footer-credit textcolor="#000"]
textcolorパラメーターで文字色を指定できます
このショートコードは「テーマ向け」ブロックパターンから挿入できます
特定の親カテゴリーを持つ子カテゴリーの一覧を表示します。
詳しくは以下のページを参照ください。
このショートコードは「テーマ向け」ブロックパターンから挿入できます
スライド式の画像に重ねてコンテンツを表示するショートコードです
このショートコードは「テーマ向け」ブロックパターンから挿入できます
インターネットエクスプローラーからアクセスされた際に、以下のような警告メッセージを表示します。
当サイトは一部のブラウザに対応していないため、お使いの環境ではページが正しく動作しない場合があります
mesパラメーターを指定することで、任意の文字列を表示させることができます。
ショートコード
[ha-iew mes='']
このショートコードは「テーマ向け」ブロックパターンから挿入できます
以下のショートコードを使うことで、更新日を基準としてその投稿の前後の投稿をカード表示できます。
前の投稿
[ha-prev-post]
後ろの投稿
[ha-next-post]
このショートコードは「コンテンツ追加」ブロックパターンから挿入できます
最新の投稿をスライド表示できるショートコードです
リンク&シェア
リンクやシェアコンテンツを作成するショートコードです
このショートコードは「リンク&シェア」ブロックパターンから挿入できます
外部・内部ページのOGPタグ情報を取得してリンクカードとして表示させるショートコードです。
仕様及び使用方法は以下のリンク先ページを参照ください。
このショートコードは「リンク&シェア」ブロックパターンから挿入できます
REST APIを利用して外部や内部サイトの情報を取得し、カードやシンプルなリストとして出力できます。
詳しくは以下のページを参照ください。
このショートコードは「リンク&シェア」ブロックパターンから挿入できます
以下のショートコードを追加することで、プライバシーポリシーページに設定した固定ページのタイトルリンクが表示できます。
[pp-link]
このショートコードは「リンク&シェア」ブロックパターンから挿入できます
REST APIを利用して外部や内部サイトの情報を混合させて、カードやシンプルなリストとして出力できます。
詳しくは以下のページを参照ください。
このショートコードは「リンク&シェア」ブロックパターンから挿入できます
外部・内部ページのスクリーンショットを取得し、本文内などへ表示させることができます。
仕様及び使用方法は以下のリンク先ページを参照ください。
このショートコードは「リンク&シェア」ブロックパターンから挿入できます
SNSへの投稿を促したり、サイト管理者宛にメールを送信したりするボタンを表示するショートコードです。
その他
その他Hima Art Utilityで使用できるショートコードです
訪問者の閲覧履歴を利用して、サイト内で1つ前に閲覧したページへのリンクを表示します。
このショートコードは「テーマ向け」ブロックパターンから挿入できます
ショートコード
[return-page]
このショートコードはブロックツールバーから挿入できます
表示するメールアドレスの難読化
ショートコードで指定したメールアドレスをHTML上へエンコードして出力することで、ロボットなどによって収集されにくくします。
[ha-email mail="メールアドレス"]
| パラメーター | 内容 |
|---|---|
| 表示するメールアドレス |
ショートコード挿入後、ソースコード表示をして、メールアドレスがそのまま表示されていないことを確認ください
メール送信リンクのメールアドレス難読化
mailtoタグ(訪問者環境のメール作成フォームを起動する機能)のメールアドレスをHTML上へエンコードして出力することで、スパムボットなどから読み取られにくくします。
また、パラメーターを使って「件名」「宛先メールアドレス」を入力した形でメール作成フォームを開くことができます。
[ha-mail-link text="リンクの文字列" mail="メールアドレス" sub="件名"]
| パラメーター | 内容 |
|---|---|
| text | リンク表示するテキスト |
| メール作成フォームに自動挿入されるメールの送信先 | |
| sub | メール作成フォームに自動挿入される件名 |
ショートコード挿入後、ソースコード表示をして、メールアドレスがそのまま表示されていないことを確認ください
このショートコードはブロックツールバーから挿入できます
パソコン表示時にモバイルでも閲覧できることを案内する文章とページURLを読み取れるQRコードを表示します
本文用ショートコード(幅広め)
[ha-qrcode]
本文用ショートコード(幅狭め)
[ha-qrcode-side]
