Files

FrankZamora 7ba9080f57 Agregar estructura completa del tema APUS con Bootstrap 5 y optimizaciones de rendimiento

Se implementa tema WordPress personalizado para Análisis de Precios Unitarios con funcionalidades avanzadas:
- Sistema de templates (front-page, single, archive, page, 404, search)
- Integración de Bootstrap 5.3.8 con estructura modular de assets
- Panel de opciones del tema con Customizer API
- Optimizaciones de rendimiento (Critical CSS, Image Optimization, Performance)
- Funcionalidades SEO y compatibilidad con Rank Math
- Sistema de posts relacionados y tabla de contenidos
- Badge de categorías y manejo de AdSense diferido
- Tipografías Google Fonts configurables
- Documentación completa del tema y guías de uso

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-11-04 09:31:47 -06:00

4.3 KiB

Raw Blame History

Quick Start Guide - Theme Options Panel

🚀 Getting Started in 3 Steps

Step 1: Access the Panel

Log in to WordPress admin
Go to Appearance > Theme Options
You'll see 5 tabs: General, Content, Performance, Related Posts, Advanced

Step 2: Configure Your Settings

Start with the General tab:

Upload your logo (recommended size: 200x60px)
Upload favicon (recommended size: 32x32px)
Enable breadcrumbs if desired
Add your social media links

Step 3: Save

Click "Save All Settings" at the bottom

That's it! Your theme is now configured.

📋 Most Common Settings

Logo and Branding

Tab: General
• Site Logo: Upload your logo image
• Site Favicon: Upload your favicon
• Copyright Text: Edit footer copyright

Content Display

Tab: Content
• Excerpt Length: 55 (default)
• Show Featured Image: ON
• Show Author Box: ON
• Enable Comments on Posts: ON

Performance

Tab: Performance
• Enable Lazy Loading: ON (recommended)
• Remove Emoji Scripts: ON (recommended)
• Remove Dashicons: ON (recommended)

Tab: Related Posts
• Enable Related Posts: ON
• Number of Posts: 3
• Relate By: Category
• Columns: 3

💡 Quick Tips

1. Export Your Settings

Before making changes, export your current settings:

Click "Export Options" button
A JSON file will download
Keep this as backup

2. Test Before Going Live

Make changes
Save
Check front-end
If something breaks, import your backup

3. Use Reset with Caution

"Reset to Defaults" will erase ALL settings
Always export before resetting

🔧 Using Options in Your Templates

Get Any Option

$value = apus_get_option('option_name', 'default_value');

Check if Enabled

if (apus_is_option_enabled('enable_breadcrumbs')) {
    // Do something
}

Common Examples

// Logo
$logo_url = apus_get_logo_url();

// Breadcrumbs
if (apus_show_breadcrumbs()) {
    $separator = apus_get_breadcrumb_separator();
}

// Related Posts
if (apus_show_related_posts()) {
    $count = apus_get_related_posts_count();
}

// Social Links
$social_links = apus_get_social_links();

🎯 Recommended Initial Configuration

For a Blog

General:
  ✅ Enable Breadcrumbs
  ✅ Add social media links

Content:
  ✅ Show Featured Image: ON
  ✅ Show Author Box: ON
  ✅ Comments on Posts: ON
  ✅ Excerpt Length: 55

Performance:
  ✅ Lazy Loading: ON
  ✅ Remove Emoji: ON
  ✅ Remove Dashicons: ON

Related Posts:
  ✅ Enable: ON
  ✅ Count: 3
  ✅ Taxonomy: Category

For a Portfolio Site

General:
  ✅ Enable Breadcrumbs
  ✅ Add social media links

Content:
  ✅ Show Featured Image: ON
  ✅ Show Author Box: OFF
  ✅ Comments on Posts: OFF
  ✅ Comments on Pages: OFF

Performance:
  ✅ Lazy Loading: ON
  ✅ Remove Emoji: ON

Related Posts:
  ⬜ Enable: OFF

For a Business Site

General:
  ✅ Upload Logo
  ✅ Update Copyright
  ✅ Add social links

Content:
  ✅ Comments on Posts: OFF
  ✅ Comments on Pages: OFF
  ✅ Layout: No Sidebar

Performance:
  ✅ All optimizations: ON

Related Posts:
  ⬜ Enable: OFF

⚠️ Troubleshooting

Settings Not Saving

Check you're logged in as admin
Check browser console for errors (F12)
Refresh the page and try again

Images Not Uploading

Check PHP upload_max_filesize (should be at least 8MB)
Try a smaller image
Check file permissions

Changes Not Showing on Site

Clear browser cache (Ctrl+F5)
Clear WordPress cache if using cache plugin
Check if you saved the settings

📚 Need More Help?

See detailed documentation:

inc/admin/README.md - Complete technical documentation
inc/admin/USAGE-EXAMPLES.php - 20 code examples
inc/admin/TEST-CHECKLIST.md - Testing guide
ISSUE-14-COMPLETION-REPORT.md - Full feature list

🆘 Support

For issues or questions:

Check browser console for JavaScript errors (F12)
Check WordPress debug.log for PHP errors
Review the documentation files above
Check TEST-CHECKLIST.md for common issues

Remember: Always export your settings before making major changes!

Quick Access: Appearance > Theme Options

Version: 1.0.0 Last Updated: 2025-11-03

4.3 KiB Raw Blame History