iPray

⌘K
  1. Home
  2. Docs
  3. iPray
  4. Installation & Setup
  5. Settings Overview

Settings Overview

When you visit Prayers → Settings, you’ll see these tabs:

1. General Tab

Controls global behavior of prayers and front-end access.

From the actual code, this includes settings like:

  • New Prayer Status

    • Publish immediately

    • Save as draft for review

  • Allow Anonymous Submissions

    • Whether users can hide their name on the prayer list.

  • Allow Comments on Prayers

    • Enables/disables the comment functionality on prayers.

  • Prayer Wall Page

    • Select a page to be used as the “main” wall (used for links in emails, etc.).

  • Prayer View Mode

    • Single Prayer Pages vs. Prayer Wall Page as the primary view.

  • Public Access

    • Whether single prayer pages are publicly viewable.

  • Detect and store submitter country

    • When enabled, the front-end form calls ipapi.co and stores the submitter’s country, which can be shown on the list.

  • Google WebFonts API Key

    • Used for typography settings in Styling (Google Fonts).

2. Notifications Tab

Controls all email triggers and notification behavior. The settings here (from the real options) include:

  • Notify Website Admin on New Draft Prayer

    • Sends an email to admin when a new prayer comes in as Draft.

  • Weekly Digest

    • Enables weekly digest emails to subscribers.

  • Notify Subscribers on New Prayer

    • Sends immediate/new-prayer notifications to subscribers.

  • Notify Submitter on New Comments

    • If prayer comments are enabled, sends an email when someone comments on a prayer.

  • Notify Submitter

    • Sends an email to the submitter when someone clicks “I prayed for this”.

  • Notify Submitter on Submission

    • Sends a confirmation email to the user when they submit their prayer.

3. Shortcodes Tab

This tab is a shortcode builder and reference UI.

Based on the actual markup and JS (ipray-admin-scripts.js), it includes:

  • A configurable builder for [ipray_list]:

    • Prayers per page

    • Show/hide pagination

    • Style (divider, border, background, shadow)

    • Layout (list or grid)

    • Grid column count

    • Auto-generated shortcode field

    • “Copy Shortcode” button

  • A builder for [ipray_subscribe_form]:

    • Form title

    • Description

    • Button text

    • Generated shortcode + copy button

  • A builder for [ipray_form]:

    • Title

    • Description

    • Button text

    • Generated shortcode + copy button

  • A builder for [ipray_dashboard]:

    • Dashboard title

    • Description

    • Login button text

    • Option to show delete button

    • Generated shortcode + copy button

  • A simple reference to legacy [ipray] (listed at the top as “Legacy shortcode showing all components together”).

4. Email Template Tab

Controls the HTML email template used for all outgoing emails.

Settings include:

  • Sender Name (e.g. “Your Church Name”)

  • Sender Email (from address)

  • Footer Note (appears in email footer)

  • Logo (for email header)

    • Uses the media uploader from the admin scripts

    • Preview shown in the settings screen

  • Body Background Color

  • Title Background Color

  • Title Text Color

  • Content Background Color

  • Content Text Color

  • Footer Text Color

These are standard WordPress color pickers, with default colors defined in the plugin.

5. Styling Tab

The Styling tab is more advanced and is powered by ipray_get_styling_fields() + ipray_render_styling_field() and some admin JS. It lets you visually style the front-end components of iPray without writing CSS.

The styling options are grouped by sections, each shown as a “postbox” with a heading and a Reset Section button:

Sections include (according to the actual styling-fields.php):

  • General typography (headings & body text)

  • Prayers List

  • Prayer Form

  • Subscription Form

  • Button

  • Prayers Dashboard

  • Comments Modal

  • Form (shared form styling)

Each section contains one or more controls, e.g.:

  • Typography controls (font size, line-height, font weight, font family, text transform)

  • Color pickers for backgrounds, borders, dividers, hover colors, etc.

  • Some fields also automatically produce RGB variants used by CSS variables.

At the top of each section:

  • There is a “Reset Section” button.

    Clicking this:

    • Shows a confirm dialog

    • Sends an AJAX request (ipray_reset_styling_section)

    • Resets only that section’s styling to its defaults

    • Shows a “Section styling has been reset.” message

    • Then reloads the page to apply defaults

A more detailed breakdown of each styling section and what it affects will be provided later in the Styling Options.

How can we help?