# font-awesome

Font Awesome

Packagist
https://packagist.org/packages/vektor-inc/font-awesome-versions

```
composer require vektor-inc/font-awesome-versions
```

翻訳：

```
composer translate
```

からの Poedit で翻訳

## 使い方

### Font Awesome 6 の更新

`npm install` を実行後 `npm run build` を実行することでその時点の FontAwesome が自動的に適用されます。

### Font Awesome のファイル自体の読み込み

以下のように書いた設定ファイルを読み込む

```
<?php
/**
 * Font Awesome Load modules
 *
 * @package vektor-inc/lightning
 */

use VektorInc\VK_Font_Awesome_Versions\VkFontAwesomeVersions;
if ( method_exists( 'VektorInc\VK_Font_Awesome_Versions\VkFontAwesomeVersions', 'init' ) ) {
	VkFontAwesomeVersions::init();
}

// カスタマイズ画面でのパネルのプリフィックス（オプション）
global $vkfav_customize_panel_prefix;
$vkfav_customize_panel_prefix = 'Lightning ';

// カスタマイズ画面でのパネルの表示順（オプション）
global $vkfav_customize_panel_priority;
$vkfav_customize_panel_priority = 560;

// タグ関連のCSSの出力する場合、ひっかけるハンドル名（オプション）
global $vkfav_set_enqueue_handle_style;
$vkfav_set_enqueue_handle_style = 'lightning-design-style';
```

### 設定画面での例の表示

```
// ページの最初記記述
use VektorInc\VK_Font_Awesome_Versions\VkFontAwesomeVersions;

// 使用する場所に記述
if ( method_exists( 'VektorInc\VK_Font_Awesome_Versions\VkFontAwesomeVersions', 'ex_and_link' ) ) {
	$example_class_array            = array(
		'v4.7' => 'fa-envelope-o',
		'v5'   => 'far fa-envelope',
		'v6'   => 'fa-regular fa-envelope',
	);
	$icon_description = VkFontAwesomeVersions::ex_and_link( 'class', $example_class_array );
}
```

### アイコンの表示

```
// ページの最初記記述
use VektorInc\VK_Font_Awesome_Versions\VkFontAwesomeVersions;

// 使用する場所に記述
if ( method_exists( 'VektorInc\VK_Font_Awesome_Versions\VkFontAwesomeVersions', 'get_icon_tag' ) ) {
	$icon_description = VkFontAwesomeVersions::get_icon_tag( 'fa-regular fa-envelope' );
}
```

#### i タグに通常の Font Awesome のクラス以外のものを追加する場合

```
$icon_description = VkFontAwesomeVersions::get_icon_tag( 'fa-regular fa-envelope', 'example-class-name' );
```

---

0.7.6
- [ 仕様変更 ] Font Awesome を 7.3.0 から 7.3.1 に更新
- [ 仕様変更 ] get_directory_uri() がファイルの置き場所を解決できなかった場合の戻り値を、空文字から wp-content の URL（末尾スラッシュ付き）に変更
- [ 不具合修正 ] シンボリックリンクで WordPress が配置された環境（AWS Bitnami 等）で Font Awesome の CSS/JS の URL のドメイン直後にスラッシュが入らず崩れ、アイコンが 1 つも表示されない不具合を修正
- [ 不具合修正 ] WP_CONTENT_DIR 等の定数が末尾スラッシュ付きで定義された環境で、Font Awesome の URL の区切りが 1 つ欠けて読み込みに失敗する不具合を修正

0.7.5
- [ 仕様変更 ] Font Awesome を 7.2.0 から 7.3.0 に更新
- [ 不具合修正 ] Font Awesome の旧バージョン設定が残っていると Fatal Error で画面全体が表示不能になる不具合を修正

0.7.4
- [ 不具合修正 ] ビルド時に webfonts (woff2) が破損し Font Awesome アイコンが表示されない不具合を修正

0.7.3
- [ 仕様変更 ] Font Awesome を 7.1.0 から 7.2.0 に更新

0.7.2
- [ 仕様変更 ] カスタムディレクトリ構成（Bedrock 等）でアセット URL が正しく生成されるように対応

0.7.1
- [ 仕様変更 ] 編集画面での読み込みの Hook を enqueue_block_assets に変更

0.7.0
- [ 仕様変更 ] Font Awesome を 7.1.0 に更新
- [ 仕様変更 ] ４系・６系を削除して７系を使用するように変更
- [ 仕様変更 ] ４系・５系の互換モードを追加
- [ 仕様変更 ] Font Awesome 7 アイコン選択時のリンク先を更新

0.6.3
- [ 仕様変更 ] Font Awesome 6.6.0 に更新
- [ 仕様変更 ] Font Awesome 6 アイコン選択時のリンク先を更新

0.6.2
- font awesome アイコンデータデータ再度更新

0.6.1
- .woff2 もバイナリである事を明示

0.6.0
- [ 仕様変更 ] Font Awesome 6.5.2 に更新
- [ その他 ] .gitattributes 追加

0.5.0
- [ 仕様変更 ] Font Awesome 5 は削除して Font Awesome 6 に自動移行
- [ 仕様変更 ] Font Awesome 6.4.2 に更新


0.4.1

- [ 不具合修正 ] WordPress.com でファイルパスが正しく取得できない不具合対応


0.4.0

- [ 機能追加 ] i タグに Font Awesome 以外のタグを追加できるように引数追加
- [ 機能追加 ] アイコンの例を書き換えられるように引数追加

  0.3.3

- [ 機能追加 ] クラス名だけでも i タグに変換して出力するメソッド追加
- [ 機能改善 ] ディレクトリ uri を グローバル変数で受け渡さなくても自動取得するように対応
- [ 仕様変更 ] グローバル変数が不適切だったため調整

  0.2.1

- [ 不具合修正 ] Font Awesome へのリンクの設定例表記が間違っていたので修正
