Troubleshooting

In the previous part, we learned about the Integration Guide. Now, we will explore troubleshooting.

Issue 1: FlipBook Not Displaying

Diagnosis:

• Shortcode syntax correct? [tnc-flip id="123"]

• HTML Block in CODE MODE? (not Visual)

• TNC FlipBook activated + licensed?

Solutions:

1. Regenerate Oxygen CSS → Oxygen → Manage → Regenerate All

2. Clear all caches (WP Rocket, Cloudflare, Oxygen Cache)

3. Test shortcode in Gutenberg first

4. Check PHP error logs for shortcode issues

Desktop Fix:

Container → Max-width: 1000px !important

Overflow: hidden

Mobile Fix:

Conditions → Mobile → Height: auto ! important

Max-width: 100vw

Checklist:

1. ACF/Custom Field contains the correct FlipBook ID

2. Field returns NUMBER (not text)

3. Test the static shortcode works first

4. Query Loop post type matches field source

5. Debug: var_dump(get_field('flipbook_id'))

CSS Fixes:

Add to Oxygen Custom CSS:

/* FlipBook Container */

.tnc-flip-container {

max-width: 1000px !important;

margin: 0 auto !important;

}

/* Mobile Responsive */

@media (max-width: 768px) {

.tnc-flip-container {

height: 500px !important;

width: 100vw !important;

}