Knowledgebase

Overview

The Calendar Tooltips feature allows you to create interactive, informational popups that appear when users hover over or click on specific terms in your church calendar. This helps provide context, definitions, and additional information about saints, feast days, liturgical terms, services, and events without cluttering the calendar display.

What are Calendar Tooltips?

Calendar tooltips are small popup windows that appear when a user interacts with highlighted terms in your calendar. They can include:

• Title - The main heading for the tooltip
• Description - Detailed information about the term
• Image - An optional icon or photo
• Link - An optional URL for more information

How Tooltips Work

1. You create a tooltip with a title, description, and list of terms to match
2. The system scans your calendar and automatically links those terms
3. When users interact with the linked terms, a styled popup appears with your content
4. Users can click through to learn more if you've included a URL

Accessing Tooltip Management

1. Log into your Site Manager
2. Navigate to Components → Monthly Calendar → Manage Tooltips
3. Click "Add New Tooltip" to create a new tooltip

Creating a New Tooltip

Step 1: Basic Information

Title (required)

• The main heading shown in the popup
• Example: "Theotokos" or "Divine Liturgy"

Slug (auto-generated)

• A URL-friendly version of the title
• Usually you can leave this blank and it will be created automatically from the title

Description

• The main content of your tooltip
• Supports rich text formatting through the editor
• Can include links, bold text, and basic HTML
• Keep it concise - aim for 2-3 sentences for best user experience

Link (optional)

• URL to a full article, Wikipedia page, or other resource
• If provided, users can click through for more detailed information

Step 2: Configure Settings

Category Choose what type of content this tooltip describes:

• General (recommended) - Appears everywhere in the calendar
• Service - Only appears in morning and evening service sections
• Feast - Only appears in feast day/title sections

Most tooltips should use "General" unless you have a specific reason to limit where they appear.

Priority (optional)

• Default is 0
• Higher numbers take precedence when multiple tooltips could match the same term
• Useful when you have overlapping terms (e.g., "St. John" vs "John the Baptist")
• In most cases, you can leave this at 0

Active

• Toggle whether this tooltip is currently enabled
• Inactive tooltips won't appear on the calendar even if their terms match
• Useful for temporarily disabling tooltips without deleting them

Step 3: Define Include Terms

This is the most important part! List all the terms that should trigger this tooltip, one per line.

Examples:

For a Pentecost tooltip:

Pentecost
Holy Trinity
Feast of the Trinity

Tips for include terms:

• Include common variations and spellings
• Include both formal and informal terms
• Include abbreviations if applicable
• One term per line
• Terms with spaces are matched as phrases
• Single words match only at word boundaries (e.g., "Fast" won't match inside "Belfast")
• Matching is case-insensitive

Step 4: Define Exclude Terms (Optional)

If certain terms should prevent the tooltip from appearing, list them here, one per line.

Use cases for exclusions:

• Prevent false matches on ambiguous terms
• Example: For a "Pentecost" tooltip, you might exclude "Sunday after" to prevent matching on "Sunday after Pentecost" references
• Example: For a "Cross" tooltip, you might exclude "crossroads" or "across"

How exclusions work:

• If any exclude term is found in the same text where an include term appears, the tooltip won't be applied
• This helps avoid incorrect matches in edge cases

Step 5: Add Featured Image (Optional)

Click the image placeholder to upload or select an image:

• Icons work well for saints and liturgical concepts
• Recommended size: 300x300 pixels or smaller
• Keep file sizes small (under 100KB) for fast loading

Step 6: Save

1. Click "Save" to create/update your tooltip
2. After saving, you'll need to rebuild the tooltip cache for your changes to appear
3. See the separate article "Rebuilding the Calendar Tooltip Cache" for instructions

Where Tooltips Appear

Tooltips can be automatically linked in several areas of the Site Manager:

Monthly Calendar

• Components → Monthly Calendar
• Feast days, morning services, and evening services
• Both the monthly grid view and daily detail views

Feasts

• Components → Monthly Calendar → Manage Feasts
• Fixed feasts (tied to calendar dates)
• Moveable feasts (tied to Pascha)

Services

• Components → Services
• Regular service schedules
• Special service announcements

Managing Existing Tooltips

Viewing All Tooltips

1. Go to Components → Monthly Calendar → Manage Tooltips
2. View a list of all tooltips with their status
3. Use the search and filter options to find specific tooltips

Editing a Tooltip

1. Click the Edit icon next to the tooltip you want to modify
2. Make your changes
3. Click "Save"
4. Important: Rebuild the cache for changes to take effect (see separate article)

Temporarily Disabling a Tooltip

1. Edit the tooltip
2. Turn off the "Active" toggle
3. Save the changes
4. Rebuild the cache
5. The terms will no longer be linked, but the tooltip configuration is preserved

Deleting a Tooltip

1. Click the Delete icon next to the tooltip
2. Confirm the deletion
3. Rebuild the cache to remove all links from your calendar

Next Steps

After creating or editing tooltips, you'll need to rebuild the tooltip cache for your changes to appear on the calendar. See the article "Rebuilding the Calendar Tooltip Cache" for detailed instructions.

If you're experiencing issues with tooltips not appearing or appearing incorrectly, see the article "Troubleshooting Calendar Tooltips" for common solutions.