Easy Social
Twitter、Facebook、LinkedIn、Pinterest、メール共有に対応したソーシャル共有ウィジェットをDrupalサイトに追加します。
easy_social
インストール
composer require 'drupal/easy_social:8.x-3.2'
概要
Easy Socialは、Drupalウェブサイトにソーシャル共有ボタンを追加するためのシンプルかつ強力な方法を提供します。このモジュールには、Twitter、Facebook、LinkedIn、Pinterest、メール共有という5つの主要な共有プラットフォームへのサポートが組み込まれています。
各ソーシャルウィジェットは、ボタンサイズ、レイアウトスタイル、言語、その他の表示設定など、プラットフォーム固有のオプションで個別に設定できます。モジュールは柔軟な表示オプションを提供しており、ウィジェットはブロックを使用して配置するか、ノード、コメント、ユーザー、タクソノミーターム、ファイルなどのサポートされているエンティティタイプに疑似フィールドとして表示できます。
Easy Socialは拡張性を念頭に設計されています。開発者はhook_easy_social_widget()を実装し、対応するテーマテンプレートを提供することで、カスタムソーシャル共有ウィジェットを簡単に作成できます。カスタムウィジェットの作成方法を示すサンプルサブモジュールが含まれています。
Features
- viaアカウント、ハッシュタグ、カウントボックスの位置、ボタンサイズ、Do Not Trackオプションでカスタマイズ可能なTwitter共有ウィジェット
- レイアウトスタイル、配色、幅、フォント、アクションタイプ（いいねまたはおすすめ）が設定可能なFacebookいいね/シェアボタン
- シェアカウンターの位置と言語設定を備えたLinkedIn共有ウィジェット
- ピンカウント表示と説明文がカスタマイズ可能なPinterest Pin Itボタン
- カスタマイズ可能な件名と本文を持つmailtoリンクによるメール共有
- 任意のテーマリージョンにソーシャルウィジェットを表示するためのブロック配置
- ノード、コメント、ユーザー、タクソノミーターム、ファイルにウィジェットを表示するためのエンティティ疑似フィールド統合
- ページパフォーマンス向上のための非同期JavaScript読み込み
- 開発者がカスタムソーシャル共有ウィジェットを作成できる拡張可能なウィジェットシステム
- ローカライズされたウィジェット表示のためのプラットフォームごとの言語設定
- タブ付き管理インターフェースによる設定
Use Cases
ブログコンテンツの共有
コンテンツリージョンにEasy Socialブロックを配置するか、記事コンテンツタイプのEasy Social疑似フィールドを有効にして、ブログ投稿にソーシャル共有ボタンを追加します。訪問者は興味深い記事をソーシャルネットワークにすばやく共有できます。
ECサイト商品のプロモーション
顧客がお気に入りの商品を共有できるように、商品ページでソーシャル共有を有効にします。Pinterest統合は視覚的な商品に特に価値があり、FacebookとTwitterは商品認知度の拡大に役立ちます。
メールによるニュースレター共有
メールウィジェットを使用して、訪問者がカスタマイズされた件名と本文でページコンテンツをメールで共有できるようにします。これは、ソーシャルメディアよりもメール共有が適切なB2Bサイトに便利です。
多言語サイトのローカライズ
TwitterとLinkedInウィジェットの言語設定を訪問者の好みの言語で表示するように設定し、国際的なオーディエンスによりローカライズされた体験を提供します。
カスタムソーシャルネットワーク統合
開発者は、hook_easy_social_widget()を実装し、サンプルモジュールのパターンに従うことで、追加のソーシャルネットワークや内部共有システム用のカスタムウィジェットを作成できます。
Tips
- 非同期JavaScript読み込み（デフォルトで有効）を有効にして、ソーシャルウィジェットスクリプトがページレンダリングをブロックしないようにします。
- エンティティ疑似フィールド表示オプションを使用して、ティーザーではなくフルノードビューにのみ共有ボタンを表示します。
- メールウィジェットは外部JavaScriptなしで動作するため、最もプライバシーに配慮した共有オプションです。
- Twitterの「Do Not Track」を設定すると、共有機能を提供しながら訪問者のプライバシー設定を尊重します。
- 推奨言語がより適切なコンテンツでは、「いいね」の代わりに「おすすめ」を表示するようにFacebookボタンをカスタマイズします。
- カスタムウィジェット作成の詳細な例については、contribフォルダ内のEasy Social Exampleサブモジュールを確認してください。
Technical Details
Admin Pages 6
/admin/config/services/easy-social
グローバルで有効にするソーシャル共有ウィジェットと、非同期JavaScript読み込みなどの詳細設定を行うメイン設定ページです。
/admin/config/services/easy-social/twitter
帰属表示、関連アカウント、ハッシュタグ、表示オプションを含むTwitter共有ウィジェットの設定を行います。
/admin/config/services/easy-social/facebook
レイアウト、外観、アクションタイプを含むFacebookいいね/シェアボタンの設定を行います。
/admin/config/services/easy-social/linkedin
カウンター表示と言語を含むLinkedIn共有ウィジェットの設定を行います。
/admin/config/services/easy-social/pinterest
ピンカウント表示とコンテンツを含むPinterest Pin Itボタンの設定を行います。
/admin/config/services/easy-social/email
ボタンの外観とデフォルトのメールコンテンツを含むメール共有ウィジェットの設定を行います。
権限 1
Hooks 3
hook_easy_social_widget
カスタムEasy Socialウィジェットを定義します。各ウィジェットには、ウィジェットのmachine_nameに対応する「easy_social_$WIDGET」という名前のテーマ実装が必要です。
hook_easy_social_widget_alter
Easy Socialウィジェット定義を使用前に変更します。他のモジュールによって定義されたウィジェットの変更や削除が可能です。
hook_easy_social_supported_entity_alter
Easy Social疑似フィールドをサポートするエンティティタイプのリストを変更します。デフォルトでは、コアエンティティタイプのみがサポートされています。
Troubleshooting 4
/admin/config/services/easy-socialのグローバル設定でウィジェットが有効になっていることを確認します。次に、表示可能なリージョンにEasy Socialブロックを配置するか、エンティティの表示管理設定でEasy Social疑似フィールドを有効にします。
Facebook SDKはページが公開アクセス可能である必要があります。サイトが認証の背後にないか、localhostでないことを確認してください。また、ブラウザコンソールでJavaScriptエラーやコンテンツセキュリティポリシーの問題がないか確認してください。
Pinterest設定でデフォルト画像URLを設定するか、ページにPinterestが検出できる適切なOpen Graphメタタグがあることを確認します。
テーマのtemplatesディレクトリでeasy_socialテンプレートをオーバーライドします。css/easy_social.cssの基本CSSもテーマのCSSを通じてオーバーライドできます。
Security Notes 4
- 「administer easy_social」権限は制限付きとしてマークされており、信頼できる管理者にのみ付与する必要があります。
- ソーシャルウィジェットはサードパーティプラットフォーム（Twitter、Facebook、LinkedIn、Pinterest）から外部JavaScriptを読み込み、ユーザーの行動を追跡する可能性があります。
- ソーシャルウィジェットを使用する際はプライバシーへの影響を考慮してください。Twitterの「Do Not Track」オプションはある程度のプライバシー保護を提供します。
- メールウィジェットはmailtoリンクを使用し、外部サーバーにデータを送信しないため、最もプライバシーに配慮したオプションです。