Knowledgebase

What is the Tooltip Cache?

The tooltip cache stores pre-processed versions of your calendar with tooltips already linked. This makes your calendar load faster for visitors because the system doesn't have to search for and link terms every time someone views a page.

When to Rebuild the Cache

You need to rebuild the cache whenever you:

• Create, edit, or delete tooltips
• Add or change include/exclude terms
• Edit calendar days that should have tooltips
• Change tooltip categories or priorities

Important: Changes to tooltips won't appear on your calendar until you rebuild the cache.

How to Rebuild the Cache

Step 1: Access the Rebuild Tool

1. Log into your Site Manager
2. Navigate to Components → Monthly Calendar → Rebuild Tooltip Cache

Step 2: Select Your Date Range

Start Date

• Enter the earliest date you want to rebuild
• Typically set this to 1 month ago to cover recent calendar edits
• Format: YYYY-MM-DD

End Date

• Enter the latest date you want to rebuild
• Typically set this to 6 months in the future to cover upcoming events
• Format: YYYY-MM-DD

Example: If today is October 10, 2025:

• Start Date: 2025-09-10 (1 month ago)
• End Date: 2026-04-10 (6 months ahead)

Step 3: Choose Your Options

Only Missing/Outdated (recommended)

• When checked, only processes calendar days that need updates
• This is faster and safer
• The system skips days where tooltips are already up-to-date
• Leave this checked unless you have a specific reason not to

Dry Run (optional)

• When checked, the system previews how many days would be affected without actually saving changes
• Useful for checking the impact before committing
• No changes are made to your calendar
• You'll see a report of what would happen

Step 4: Run the Rebuild

1. Click "Rebuild Tooltip Cache"
2. The system will process all days in your date range
3. A progress indicator will show the rebuild is running
4. When complete, you'll see a summary:
   • Number of days updated
   • Number of days skipped
   • Total processing time

Processing Time: Typically 5-10 seconds for a 7-month range.

Understanding the Results

After the rebuild completes, you'll see a summary message:

"Rebuild complete. Updated rows: 45. Skipped: 168."

This means:

• 45 calendar days had tooltips added or updated
• 168 calendar days were skipped because they were already up-to-date
• Total days processed: 213 (45 + 168)

What Happens During Rebuild

The system performs these steps for each day in your date range:

1. Scans the calendar text - Looks at feast names, morning services, and evening services
2. Searches for include terms - Finds all terms from your active tooltips
3. Checks exclude terms - Verifies no exclude terms are present that would block the match
4. Creates links - Wraps matched terms with special markup for the popup functionality
5. Stores in cache - Saves the processed HTML for fast loading

Verifying the Rebuild

After rebuilding, check that your tooltips appear correctly:

1. Navigate to your public calendar view
2. Find a date that should have tooltip terms
3. Look for underlined or highlighted terms
4. Hover over or click a term to see if the popup appears
5. Verify the popup contains the correct information

Tips for Efficient Rebuilding

Use appropriate date ranges:

• Don't rebuild your entire calendar unless necessary
• Focus on the date range where you made changes
• Include a buffer before and after your changes

Rebuild strategically:

• If you're making multiple tooltip edits, make them all first, then rebuild once
• Rebuilding after every single edit is inefficient
• Batch your changes when possible

Keep "Only Missing/Outdated" checked:

• This prevents unnecessary processing
• The system is smart about what needs updating
• Only uncheck if you're troubleshooting a specific issue

Troubleshooting Rebuild Issues

Rebuild taking too long

• Reduce your date range
• Make sure "Only Missing/Outdated" is checked
• Try running during off-peak hours

No rows updated

• The system may have already processed those days
• Try unchecking "Only Missing/Outdated" to force a rebuild
• Verify your tooltips are marked as Active

Changes still not appearing

• Clear your browser cache (Ctrl+F5 or Cmd+Shift+R)
• Try viewing in an incognito/private window
• Verify the rebuild included the dates you're viewing
• Check that the tooltip terms actually appear in your calendar text

When to Use Dry Run

Use the Dry Run option when:

• Testing a new tooltip to see how many days it will affect
• Verifying changes before committing them
• Troubleshooting why tooltips aren't appearing
• Checking the impact of a major tooltip reorganization

After reviewing the dry run results, uncheck the option and run the rebuild for real.

Regular Maintenance

Recommended schedule:

• After making any tooltip changes (immediately)
• Weekly during active calendar editing periods
• Monthly as part of regular site maintenance

The rebuild process is fast and safe, so don't hesitate to run it whenever you make changes.