faithcatholic/faith_subscriptions_lectionary

Provides lectionary entity type.

1.0.2 2023-07-06 19:18 UTC

GPL-2.0-or-later

• Nicholas Ketchum

README

This module provides a new content entity: lectionary. Lectionaries are numbered lists of specific biblical readings that match a particular theme, which are standarzied across the Church. This information is usually displayed within the main site content.

This data is stored as an entity to improve re-usability. Lectionaries are a somewhat standard set of readings within the Church, and keeping this data in a separate entity allows easier modification in the future without jeopardizing functionality of other content. This model also avoids duplicating data that may prove troublesome.

How to use this module

1. Verify that the prerequisite module will work with your website: - drupal/auto_entitylabel
2. Download the module from packagist using composer:

$ composer require faithcatholic/faith_subscriptions_lectionary

1. Enable the module via drush or within the administration area:

$ drush en faith_subscriptions_lectionary

1. Navigate to the content overview page at Admin > Content in the administrator toolbar.
2. Find the new tab above the content area called Lectionaries. This tab loads a page that shows a full list of existing lectionaries that have been saved to the website.
3. Choose a content type in which to add lectionary functionality. Using the admin toolbar, go to Admin > Structure > Content Types > My Type. On the next screen, click Manage Fields and add a reference field:
   • Click the + Add field button.
   • Select Reference > Other... in the Add a new field dropdown and provide a label for the field.
   • On the next page, choose the Lectionary option under the Type of item to reference dropdown list.
   • Make sure Allowed number of values is set to 1.
4. Now select the Manage Form Display tab for your content type, and set the form widget to be Inline entity form - Complex in the dropdown form.
   • Set the form display. Set options by clicking the gear icon on the far right-hand side of the applicable field in the list of fields.
   • Leave the form default settings as-is except those below:
     • ☑ Allow users to add new nodes.
     • ☑ Allow users to add existing nodes. Leave widget to add existing nodes as Autocomplete
     • ☑ Allow users to edit existing nodes. Leave autocomplete matching as Contains.
   • Set Keep or delete unreferenced nodes to Keep always.
5. Under the Manage Display tab of your content type, move the field display if necessary and choose the label option.
6. That's it! You're ready to add lectionaries.
   • Best practice is to set up a content type, add an entity reference field for lectionaries as described in steps 6 and 7, and save the field. Then create content of that type and add a lectionary directly within the node add/edit form.
   • You can also create/edit/delete lectionaries on its admin overview page. Go to Admin > Content > Lectionaries and click the + Add lectionary button.