Descripción
EvangelOS Sync is the official WordPress plugin for EvangelOS, the church management system built for modern ministries.
Once connected, your WordPress site stays automatically in sync with your EvangelOS account — events appear on your website the moment they’re created in EvangelOS, sent announcements and newsletters are published as posts, and website visitors can submit prayer requests directly into your EvangelOS prayer request queue.
What it does
Events sync — Public church events created in EvangelOS are automatically imported into a church_event custom post type in WordPress. Events are updated when they change in EvangelOS, and optionally trashed when they’re deleted. Supports filtering to upcoming-only and public-only events.
Communications sync — Sent announcements, newsletters, and other communications from EvangelOS are automatically published as WordPress posts, organized into categories. Great for keeping your website’s news section current without copy-pasting.
Prayer requests — Add the [evangelos_prayer_request] shortcode to any page to display a prayer request form. Submissions go directly into EvangelOS so your pastoral team sees them immediately. A /prayer-requests/ page is created automatically on activation.
Features
- One-click connection test to verify your API key
- Configurable sync schedule: hourly, twice daily, or daily
- Sync history dashboard showing the last 25 runs with created/updated/skipped/error counts
- Manual sync trigger — no need to wait for the scheduled run
- Smart upsert logic — only writes to the database when data has actually changed
- Optional deletion sync — trash WordPress content when it’s removed from EvangelOS
- Lightweight — no bloat, no third-party dependencies, uses WordPress core HTTP APIs
Requirements
- An active EvangelOS account
- An API key generated in EvangelOS under Settings API
- For prayer requests: a Website Guest member created in EvangelOS and the
MEMBER_PORTAL_ACCESSpermission enabled on your API key
Instalación
- Upload the
evangelos-syncfolder to the/wp-content/plugins/directory, or install directly through the WordPress Plugins screen. - Activate the plugin through the Plugins screen in WordPress.
- Go to EvangelOS Settings in the WordPress admin sidebar.
- Enter your EvangelOS API URL (default:
https://api.evangelos.app) and your API Key (starts withek_). - Click Save Settings, then click Test Connection to confirm everything is working.
- Configure your sync schedule and choose which content types to sync.
- To enable prayer requests: create a member named “Website Guest” in EvangelOS, copy their Member ID, and paste it into the Prayer Requests section. Then add
[evangelos_prayer_request]to any page — or use the/prayer-requests/page created automatically on activation.
FAQ
-
Where do I get an API key?
-
Log in to your EvangelOS account, go to Settings API, and generate a new key. Keys start with
ek_. Keep your key private — it provides access to your organization’s data. -
What is the “Website Guest” member?
-
When a visitor submits a prayer request through your website, EvangelOS needs a member to file it under. Create a placeholder member in EvangelOS called “Website Guest” (or similar), then copy their Member ID (a UUID) into the plugin’s Prayer Requests settings. The visitor’s name and email are appended to the request text so your pastoral team knows who sent it.
-
How often does the sync run?
-
You can choose hourly, twice daily (every 12 hours), or daily. You can also trigger a manual sync at any time from the Sync Status tab. Sync runs are powered by WordPress cron (
wp-cron), so they depend on site traffic. On low-traffic sites, consider using a server-side cron job to callwp-cron.phpdirectly. -
Will it overwrite content I’ve edited in WordPress?
-
The plugin uses an update-timestamp check — if EvangelOS reports that a record hasn’t changed since the last sync, the WordPress post is left untouched. However, if the record is updated in EvangelOS, the sync will overwrite the WordPress post content with the new data from EvangelOS. Treat EvangelOS as the source of truth for synced content.
-
What happens to events deleted in EvangelOS?
-
By default, nothing — the WordPress post is left in place. If you enable Trash WordPress events deleted in EvangelOS in Settings, deleted events will be moved to the WordPress Trash (not permanently deleted) on the next sync.
-
Can I use this without an EvangelOS account?
-
No — the plugin requires a live EvangelOS account and API key to function. Visit getevangelos.com to learn more.
-
Does this work with any WordPress theme?
-
The event sync creates a
church_eventcustom post type. Your theme needs to support (or at least not conflict with) custom post types to display events. The communications sync uses standard WordPress posts, which work with any theme. The prayer request form renders with basic styles that you can override in your theme’s CSS. -
Is my API key stored securely?
-
Your API key is stored in the WordPress options table, the same way WordPress stores all plugin settings. For additional security, we recommend restricting database access on your server and using a dedicated low-permission API key in EvangelOS that is scoped to read-only access (plus
MEMBER_PORTAL_ACCESSif using prayer requests).
Reseñas
No hay reseñas para este plugin.
Colaboradores y desarrolladores
«EvangelOS Sync» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
Traduce «EvangelOS Sync» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
1.0.1
- Fix: “Email” is now a selectable communication type in Settings, matching what the sync engine already supported (previously arbitrarily limited to four of the five supported types).
- Fix: Escape the admin settings link output with
esc_url()/esc_html__()(late escaping).
1.0.0
- Initial release.
- Events sync: EvangelOS events
church_eventcustom post type with full field mapping. - Communications sync: Sent EvangelOS communications WordPress posts organized by category.
- Prayer requests:
[evangelos_prayer_request]shortcode with AJAX form submission. - Admin UI: two-tab settings and sync status page with branded header, connection tester, manual sync, and 25-run history.
- Configurable cron schedule (hourly / twice daily / daily) with auto-reschedule on settings change.
- Smart upsert logic with change-detection to minimize unnecessary database writes.