Drupal 7のオーガニックグループ

Drupal 6のオーガニックグループ（OG）は、より大きなDrupalサイトのミニサイトであるグループを含むサイトを作成するための強力で広く使用されているモジュールです。 Drupal 7のOGバージョンは完全に書き直され、エンティティとフィールドのAPIでDrupal 7の利点が具体化されました。



Drupal 6バージョンとDrupal 7バージョンの主な違いの1つは、「グループ」とは何かという概念の開発です。 D6では、グループはノードであり、他のノードはグループコンテンツとしてサブスクライブできました。 D7では、任意のタイプのエンティティをグループにすることができ、任意のタイプのエンティティをグループに所属させることができます。



この記事では、OGアーキテクチャ全体を見て、D7で最初のグループを構築するために最後まで進みます。

グループとは何ですか？

下の図をご覧ください。 グループはさまざまな種類のエンティティで構成されていることがわかります。 中央にあるのはノード自体であり、グループです。 親グループの本質は、グループであるすべての人のためです。







ユーザーとコンテンツは、グループに属する2種類のエンティティです。 各ユーザーと各コンテンツは、追加のエンティティを使用してグループに参加します。 比Fig的に言えば、これは特定のグループに関連付けられているエンティティを追跡するテーブル内の単純なエントリです。



実際、現在のアーキテクチャには、2つの異なるタイプのエンティティ「グループ」があります。 1つは「グループ」として指定したコンテンツのタイプであり、2つ目はおそらくここでは実装しない特別なOGエンティティです。 OGエンティティには、グループ自体とグループ識別子（GID）の両方が含まれます。 これは、D7のOGアーキテクチャに関する最もわかりにくいものの1つです。 GIDとNIDは2つの異なる概念であることに注意してください。 これは将来変更される可能性があるため、記事の最後にあるリンクを確認してください。

エンティティグループ

OGを開始するには、どのタイプのエンティティが「親」になるかを決定する必要があります。 D6では、これは常に材料のタイプでしたが、D7では、任意のタイプのエンティティにできます。 まだいくつかのタイプのコンテンツになりますが、しない方が良いです。 別のパスの例としては、energy.govがあります。この場合、グループは分類用語に基づいて構築されます。



たとえば、「グループ」と呼ばれる種類のマテリアルを作成します。これは、OGバージョンD6で発生したものと同様のコンテナになります。

OGコンテンツ

次に行う必要があるのは、どのタイプのエンティティがグループに属するかを決定することです。 既存の種類のコンテンツを使用できます。



グループコンテンツは、ノードの性質やコンテンツのタイプに限定されません。 他のタイプのエンティティはグループに属する場合があります。 利用可能なエンティティは、サイトにインストールされているモジュールによってのみ制限されます。 たとえば、メディモジュールがサイトにインストールされている場合、メディアエンティティはグループの一部になることができます。



ユーザーは、他の特別なタイプのグループエンティティコンテンツです。 これらはグループに参加し、「グループメンバーシップ」コンテンツでもありますが、さらに多くのプロパティがあり、ユーザーはグループと対話するためのロールと権限を持つことができます。



どのタイプのエンティティもグループに属することができます。 実際、グループ自体は別のグループに属している場合があります。 これにより、グループを結合してサブグループを作成できます。

モジュールをダウンロードしてアクティブ化する

エンティティがそれ自体とどのように相互作用するかについての図を思い描いたので、OGモジュールをダウンロードしてアクティブ化することにより、サイト上でこれを構築することができます。 OGはEntity APIモジュールに依存しているため、これも必要です。 （翻訳者からの注記：「クリーンインストール」には、モジュールが必要です：CTools、entityrefference、views一括操作およびビュー）



D6 OGバージョンはモノリシックモジュールで、グループを作成するためにすべてを「箱から出して」実際に提供しました。 D7バージョンでは、他の方法で行っていました。 各モジュールには、独自の高度に特殊化されたタスクを持つ独自のモジュールがあります。 タスクの一部は別のプロジェクトに提出されました。



以下は、個別のモジュールで提出されたプロジェクトの一部です。

• OGコンテンツリンク -「コンテンツの追加」リンクを作成して、グループにコンテンツを追加できます
• OGビュー -「グループビュー」フィールドがあり、グループの表示に追加できます。 このモジュールはビューの統合を必要としませんが、状況は将来変更される予定であることに注意してください。 パネルを使用せずにグループページのビューからコンテンツを埋め込む場合は、このフィールドを使用できます。
• OGテーマ -ユーザーがグループのテーマを選択できる「グループテーマ」フィールドを作成します。
• OG言語 -「グループ言語」フィールドで、ユーザーがグループの言語を選択できるようにします。

OGコア内にも変更がありました。 たとえば、OGに付属するモジュールはOG Contextと呼ばれます。



OG UIも別のモジュールで取り出されます。 OGカーネルのみをアクティブにし、OGに関連するものを管理メニューに表示したくない場合は、このモジュールをスキップしてください。 この理由は、すでに設定済みのすべてのグループであり、何も設定する必要がなくなったためかもしれません。

チームを構築する

D7バージョンでは、カーネルのフィールドを使用して、特別なフィールドを使用してこれらすべてのエンティティを接続します。 以前にノード参照フィールドを使用したことがある場合、おなじみのパターンを認識できます。各エンティティには、エンティティの相互接続方法を示すフィールドがあります。 これを行うには、エンティティにOGフィールドを追加するか、ノード参照フィールドを追加する方が便利な場合があります。



そこで、新しいタイプのコンテンツを作成し、「グループ」という名前を付けることから始めます。 ページを下にスクロールして、[グループ]タブを表示します。このタブでは、このコンテンツがグループかグループのコンテンツかを指定できます。 これはグループであることに注意してください。



次に、既存のコンテンツタイプを編集するか、新しいコンテンツタイプを作成する必要があります。 同じ「グループ」タブを使用して、このタイプがグループのコンテンツであり、グループに関連付けられることを示します。



コンテンツタイプをグループコンテンツとしてマークした後、各コンテンツタイプの「フィールド管理」画面に移動して、OGフィールドを追加する必要があります。 これを行うと、どのコンテンツがどのグループに属するかをフィールドから選択する機会があることがわかります。 ただし、ここには他の特別なフィールドは表示されません。 これは、D7バージョンのもう1つのわかりにくい側面です。 [フィールドマネージャー]画面からフィールドを完全に制御することはできません。



OGに特別なフィールドを追加するには、OGの管理部分に移動する必要があります。 以下にスクリーンショットが表示されている管理画面を見てください。オプションには番号が付いています。 これは、OGフィールドを構成するために必要なものです。



たとえば、admin / config / group / fieldsリンクで、スクリーンショットに似たものを見ることができます。





一部のフィールドは、コンテンツのタイプをグループまたはグループコンテンツとしてマークしたときに自動的に生成されましたが、グループエンティティとグループコンテンツには必要なフィールドがありません。 残りのフィールドを追加するには、上部セレクターでエンティティまたはノードをマークし、追加する下部フィールドで選択する必要があります。 利用可能なフィールドは、グループおよびグループコンテンツのサブグループに分類され、どこに何を追加できるかを通知します。 フィールドを追加するには、上部でコンテンツタイプを選択し、下部でフィールドを選択して、「フィールドを追加」をクリックする必要があります。



プライベートグループを作成したい場合は、グループに「グループの可視性」フィールドを追加できます。 グループ内のグローバルロールによって既存の部門をオーバーラップする場合、「グループロール」エンティティに「グループロールと権限」フィールドを追加する必要があります。 上記の他の外部モジュールを使用する場合、フィールドをグループコンテンツへのリンクとして追加するオプションが表示されます。



グループコンテンツエンティティには異なるフィールドがあります。 「グループオーディエンス」フィールドと、場合によっては「グループの可視性」フィールドを与える必要があります（グループ作成者に可視性を選択する機会を与えるため）。



「ユーザー」エンティティには、グループコンテンツと同じ「グループオーディエンス」フィールドがあり、これはどのグループがどのユーザーに属しているかを追跡するために使用されます。



すべてのフィールドを設定したら、どのフィールドがどのエンティティに属するかを選択できます。





このステップから、エンティティのフィールド管理画面に戻ることができ、必要に応じてソートできるすべてのOGフィールドを見ることができます。 すべての設定を確認できます。 各設定をダブルチェックして、「グループオーディエンス」フィールドの値が正しいことを確認できます。 ユーザーまたはマテリアルを追加する権限をマークすることもできます。







フィールド管理画面に表示されるフィールドを変更する必要がある場合があります。 多くのOG特殊フィールドには、グループサブスクリプションと呼ばれる形式があります。 この設定により、ユーザーの許可に基づいて出力を生成できます。 ユーザーがグループのメンバーではない場合、グループに参加するためのリンクが表示されます。 ユーザーがグループのメンバーである場合、ユーザーが既にメンバーシップの役割を持っていることを示します。



これらの設定を使用して、新しいグループノードを作成でき、ノード編集画面にOGフィールドが表示されます。 そこで、これらのエンティティのどれをグループにするか、パブリックかプライベートか、どのエンティティとやり取りするか、グループのコンテンツを選択することができます。



完成したノードは次のようになります。





これで、グループのステータス、グループの説明、新しいコンテンツを追加するためのリンク、およびグループの既存のコンテンツを表示できます（もちろん存在する場合）。 また、グループ管理者には、グループとその管理を編集するタブが表示され、グループメンバーなどを管理できます。

次のステップ

私たちがしたことは、文字通り、OGからできることの芽です。 開発と開発のためにまだ受けました。 管理ページに戻って、すべてのオプションの調査を続けることができます。 たとえば、グループのグローバルロールと権限のオプションを構成します。



ビューに移動して、コンテンツおよびグループメンバーのカスタムビューを設定することもできます。 そしてもちろん、Panelsを使用してすべてを接着することができます。 したがって、これらは最も単純な構成でOGに含まれる可能性のあるおおよその可能性にすぎません（機能、CTools、およびパネルが必要になります）。



上記で、アーキテクチャの変更が発生する可能性があることを述べました。 これは、リクエストで解放されたOGエンティティを取得するためです。 主なアイデアは、グループエンティティがグループで、グループエンティティIDがグループGIDである場合、OGの構成と編成を簡素化し、D6で使用されるテンプレートに戻ることです。 ようこそスポンサーシップAmitaibu（Amitai Burstein）はOG開発者です。