7ba9080f57
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>
228 lines
4.3 KiB
Markdown
228 lines
4.3 KiB
Markdown
# 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
|