Questo modulo estende l'API delle entità del core di Drupal per fornire un modo unificato di gestire le entità e le loro proprietà. Inoltre, fornisce un controller CRUD di entità, che aiuta a semplificare la creazione di nuovi tipi di entità.

Requisiti

  • Drupal 7.2 o successivo; suggerito Drupal >= 7.15

Documentazione

Puoi trovare la documentazione nei manuali . Controlla anche il README e i documenti API forniti in .entity.api.php

Panoramica

Per i webmaster

Questo è un modulo API, quindi non fornisce funzionalità per l'utente finale. Tuttavia, fornisce alcune funzionalità generiche di entità ad altri moduli che i costruttori di siti possono sfruttare:

  • Un plug-in di visualizzazione di Views e un campo per il rendering o il collegamento a qualsiasi entità (per modalità di visualizzazione)
  • Un plug-in di contenuto CTools per eseguire il rendering di qualsiasi entità (in modalità di visualizzazione)
  • Viene fornito con il modulo Entity tokens che assicura la presenza di token per la maggior parte delle proprietà e dei campi dell'entità, ovvero fornisce sostituti token per tutte le proprietà dell'entità (o campi) che non hanno token e sono noti al modulo dell'entità (leggi la proprietà dell'entità informazioni API di seguito).

Per gli sviluppatori

  • Il modulo fornisce funzioni API consentono moduli per creare, salvare, eliminare, visualizzare o per determinare l'accesso per qualsiasi entità, cioè entity_create()entity_save()entity_delete()entity_view()entity_access()
  • L'API entità avvia un luogo unico per i metadati sulle relazioni di entità e le proprietà di entità: Queste informazioni sulle proprietà dell'entità contengono il tipo di dati e i callback su come ottenere e impostare i dati di una proprietà. I moduli possono fare affidamento su queste informazioni per supportare qualsiasi proprietà dell'entità, ad esempio le regole e l' API di ricerca si basano su di esse. hook_entity_property_info()
  • Inoltre il modulo fornisce wrapper di dati che utilizzano le informazioni disponibili per fornire un accesso semplice e unificato alle entità e alle loro proprietà. Per esempi di utilizzo dai un'occhiata al README o ai test forniti.
  • Oltre a ciò, il modulo ti aiuta a definire un nuovo tipo di entità. Per questo, fornisce un controller di entità, che implementa la funzionalità CRUD completa per le tue entità. Facoltativamente, le entità possono essere create in base a classi derivate dalla Entityclasse fornita .
  • L'API dell'entità si occupa della creazione di entità fieldable , eventualmente revisionabili, nonché entità esportabili . Inoltre, supporta l'implementazione di entità bundle, ovvero oggetti bundle (come i tipi di nodo) per entità fieldable implementate come entità (esportabili), per le quali vengono richiamati automaticamente i callback API di campo appropriati.
  • Per i tipi di entità implementati in base all'API CRUD fornita, l'API fornisce anche l'integrazione di moduli aggiuntivi, ovvero gli eventi delle regole vengono forniti per tutti gli hook relativi a CRUD, vengono fornite alcune informazioni di base sulle proprietà dell'entità e le entità esportabili vengono integrate automaticamente con il modulo Funzionalità . Queste integrazioni di moduli sono implementate in classi di controller separate, che possono essere sovrascritte o abilitate/disattivate separatamente. hook_entity_property_info()
  • Facoltativamente, l'API dell'entità aiuta anche a fornire un'interfaccia amministrativa per la gestione delle entità, ad esempio l'interfaccia utente per la gestione dei tipi di profilo del Profilo 2 è costruita con quella.

I cambiamenti

Si prega di consultare i record delle modifiche per ottenere un elenco di modifiche importanti - applicabili a costruttori e sviluppatori di siti! Non dimenticare di eseguire update.php dopo l'aggiornamento.

Nota sulla compatibilità : se viene utilizzato il modulo i18n Translation Sets (i18n_translation), è necessaria una versione i18n 1.5 o successiva!

Drupal 8

  • L'API Entity core di Drupal 8 è notevolmente migliorata, quindi la maggior parte delle funzionalità fornite dalla versione Drupal 7 sono già presenti nel core di Drupal.
  • La versione Drupal 8 del modulo Entity API viene utilizzata per miglioramenti all'Entity API di Drupal 8 che verrà spostata al core Drupal un giorno (sviluppo in corso)

Titoli di coda

Il progetto è stato patrocinato da

Manutentore

Organizzazioni di supporto: 
 Manutenzione
 Sviluppo iniziale supportato