Prayer Requests =============== Prayer requests are available to all clients with little to no additional setup required. Prayer requests can be accessed via: * the free or paid mobile app, * a stand alone form, or * a form embedded in your website :ref:`(additional setup required) `. Optional Settings for Prayer Requests ------------------------------------- Navigate to `Administration > Setup > Settings > Features > Prayer Requests`. The following settings control how prayer requests come into TouchPoint. AnonymousPerson Set the Value to the name of the person (or record) where anonymous or unmatched prayer requests will be linked. If no value is set, the system will default to using User ID 1. If there is no User ID 1, it will use the record with the **admin** username. This person will be the **About Person** *and* the **Owner** if prayer requests are created as Notes. If prayer requests are created as Tasks, this will be the **About Person**. .. tip:: We recommend creating a record named **Prayer Requests** in your database and using that as the `AnonymousPerson` record. LimitToRoleForPrayerRequests This will limit all prayer requests that are submitted to the chosen role. MakeTaskOwner All prayer requests are created as Notes by default. If you prefer to have prayer requests created as Tasks, set the value to the person who should own those tasks. .. figure:: https://i.tpsdb.com/2021-12-10-030208.png :target: # Example prayer requests displayed as a Task and Note Prayer Request Default Shell This will allow you to set a shell so that the form can be used as a stand alone page or embedded directly into your website. **Stand Alone** - The setting must be populated. If you don't have a custom shell, populate the shell named ``ShellDefaultBs`` in the setting. This is a TouchPoint standard shell which already exists on your database. **Embed Into Your Website** - We recommend that you create a shell that has nothing in it. To do this, go to `Settings > Special Content` and click the green `+New Html File` button on the `Html Content` tab. Name your shell, but add no content and then save. Enter the name of that shell in the setting. This will allow the prayer request form to be seemlessly embedded into your website. .. _EmbedInWebsite: Embed into Your Website ----------------------- Some additional work (beyond the administrative settings) is required to embed the prayer request form into your website. * Embed the following code into your website: ````. Replace ``yourchurchname`` with your domain name. Adjust the pixel size as needed. * In order for the form to work you'll need to add a Content Security Policy to your website. To do that: - Access your website's head-section.html file. - Add ```` between the ```` tags. Replace ``yourchurchname`` with your domain name. Keywords -------- The following keywords are used with prayer requests. *These keywords cannot be deleted.* Mobile Prayer Request This is attached to all prayer requests submitted from the mobile app. Anonymous Prayer Request This is attached to a prayer request when the mobile app submitter enables the `Anonymous` toggle. Prayer Request Unauthenticated This is attached to all unauthenticated and unmatched prayer requests submitted through the web form or mobile app. If an unauthenticated submitter enters his or her name AND email address, they will be attached to the task or note. .. note:: ALL prayer requests submitted using either the stand alone form or embedded in your website will be considered an unauthenticated prayer request. This is because someone is not logged in when the prayer request is submitted. However, if a person includes BOTH a name and email address that is found in your database, the prayer request will be attached to that person. Submitting Prayer Requests via the Mobile App --------------------------------------------- Logged In ~~~~~~~~~ Step 1 Tap the `Prayer Request` option under `My Activity` or tap the Prayer Requests tile (if it exists). Step 2 Enter your `Prayer Request`. .. important:: A prayer request must include a **minimum of 10 characters**. Step 3 (optional) Toggle the `Submit Anonymously` if you do not want your name associated with the prayer request. Step 4 Click the `Submit` button. .. figure:: https://i.tpsdb.com/submitprayerrequest.png :target: # | Not Logged In ~~~~~~~~~~~~~ Step 1 Tap the `Prayer Request` option. Step 2 (optional) Enter your `First and Last Name`. If you do not enter this information, your prayer request will be submitted anonymously. Step 3 (optional) Enter your `Email Address`. If you do not enter this information, your prayer request will be submitted anonymously. Step 4 Enter your `Prayer Request`. .. important:: A prayer request must include a **minimum of 10 characters**. Step 5 Click the `Submit` button. .. figure:: https://i.tpsdb.com/submitanonymousprayerrequest.png :target: # | Submitting Prayer Requests via the Stand Alone Form --------------------------------------------------- Step 1 The URL for the form is ``https://yourchurchname.tpsdb.com/prayerrequest``. Replace ``yourchurchname`` with your domain name. Step 2 (optional) Enter your `First and Last Name`. If you do not enter this information, your prayer request will be submitted anonymously. Step 3 (optional) Enter your `Email Address`. If you do not enter this information, your prayer request will be submitted anonymously. See NOTE regarding Prayer Request Unauthenticated keyword. Step 4 Enter your `Prayer Request`. .. important:: A prayer request must include a **minimum of 10 characters**. Step 5 Click the `Submit` button. .. figure:: https://i.tpsdb.com/Staci/PR-StandAlone.png :target: # .. note:: The shell entered in the `Prayer Request Default Shell` setting will determine the style. The example above is using the ``StandardShellwBackground``. The name entered in the setting must match exactly the name of the shell file and is case sensitive. Submitting Prayer Requests via form Embedded in your Website ------------------------------------------------------------ Step 1 Go to your church website and scroll to find the prayer request form. Step 2 (optional) Enter your `First and Last Name`. If you do not enter this information, your prayer request will be submitted anonymously. Step 3 (optional) Enter your `Email Address`. If you do not enter this information, your prayer request will be submitted anonymously. See NOTE regarding Prayer Request Unauthenticated keyword. Step 4 Enter your `Prayer Request`. .. important:: A prayer request must include a **minimum of 10 characters**. Step 5 Click the `Submit` button. .. figure:: https://i.tpsdb.com/Staci/PR-Embed.png :target: # .. note:: The shell entered in the `Prayer Request Default Shell` setting will determine the style. Our recommendation is to create a shell file that is blank. Doing so will embed the prayer request seemlessly into your website. The name entered in the setting must match exactly the name of the shell file and is case sensitive. Prayer Digest Email/Report -------------------------- The Prayer Digest can function as an automated email or as a stand-alone report or as both. The report shows prayer requests that have been made online over the past specified number of days and can be added to the Reports menu for easy access. The automated email contains the same information as the report and is sent on the specified schedule to the specified recipient(s). .. seealso:: :doc:`../CustomProgramming/Python/Scripts/PrayerDigest` | | +--------------------+------------------+ | **Latest Update** | **06/16/2023** | +--------------------+------------------+ Corrected Default Shell instructions