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>
This commit is contained in:
FrankZamora
227
wp-content/themes/apus-theme/QUICK-START-OPTIONS-PANEL.md
Normal file
227
wp-content/themes/apus-theme/QUICK-START-OPTIONS-PANEL.md
Normal file
@@ -0,0 +1,227 @@
|
||||
# Quick Start Guide - Theme Options Panel
|
||||
|
||||
## 🚀 Getting Started in 3 Steps
|
||||
|
||||
### Step 1: Access the Panel
|
||||
1. Log in to WordPress admin
|
||||
2. Go to **Appearance > Theme Options**
|
||||
3. 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)
|
||||
```
|
||||
|
||||
### Related Posts
|
||||
```
|
||||
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
|
||||
```php
|
||||
$value = apus_get_option('option_name', 'default_value');
|
||||
```
|
||||
|
||||
### Check if Enabled
|
||||
```php
|
||||
if (apus_is_option_enabled('enable_breadcrumbs')) {
|
||||
// Do something
|
||||
}
|
||||
```
|
||||
|
||||
### Common Examples
|
||||
```php
|
||||
// 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
|
||||
1. Check you're logged in as admin
|
||||
2. Check browser console for errors (F12)
|
||||
3. Refresh the page and try again
|
||||
|
||||
### Images Not Uploading
|
||||
1. Check PHP upload_max_filesize (should be at least 8MB)
|
||||
2. Try a smaller image
|
||||
3. Check file permissions
|
||||
|
||||
### Changes Not Showing on Site
|
||||
1. Clear browser cache (Ctrl+F5)
|
||||
2. Clear WordPress cache if using cache plugin
|
||||
3. 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:
|
||||
1. Check browser console for JavaScript errors (F12)
|
||||
2. Check WordPress debug.log for PHP errors
|
||||
3. Review the documentation files above
|
||||
4. 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
|
||||
Reference in New Issue
Block a user