# NaughtyWP Theme Documentation
Table of Contents
Introduction
Theme Features
Installation
Theme Structure
Theme Setup and Configuration
Theme Options
Page Templates
Custom Post Types and Taxonomies
Video Management
SEO Features
Theme Customization
Optimization Features
Troubleshooting
Support
Introduction
NaughtyWP is a lightweight, responsive WordPress theme specifically designed for adult tube sites. Built with Bootstrap 5, the theme offers high performance, SEO optimization, and a dark-themed interface that is perfect for video content.
Theme Features
Responsive Design: Fully responsive layout based on Bootstrap 5
Dark Theme: Built-in dark theme for better viewing experience
Video Management: Advanced video embedding and management capabilities
SEO Optimized: Schema markup and customizable meta tags
Performance Optimized: Lightweight design with CSS optimization
Sort and Filter: Video sorting options (most viewed, top rated, etc.)
Custom Taxonomies: Support for categories, tags, and actors/models
Advertisement Integration: Multiple ad placement areas
Analytics Integration: Easy integration of tracking codes
Social Media Integration: Customizable social media links
Bulk WebP Converter: Tool to convert images to WebP format for better performance
Installation
Upload the `naughtywp-theme` folder to your `/wp-content/themes/` directory
Upload the `naughtywp-videos` folder to your `/wp-content/plugins/` directory
Activate the NaughtyWP theme through the 'Appearance > Themes' menu in WordPress
Activate the NaughtyWP Core plugin through the 'Plugins' menu in WordPress
Navigate to 'NaughtyWP License' to activate your theme license
Theme Structure
naughtywp-theme/
├── 404.php # 404 error page
├── archive.php # Archive template
├── category-list-template.php # Categories list page template
├── comments.php # Comments template
├── footer.php # Footer template
├── functions.php # Theme functions
├── header.php # Header template
├── index.php # Main template
├── models-template.php # Models/Actors list page template
├── naughtywp-seo-functions.php # SEO functions
├── naughtywp-theme-options-tabbed.php # Theme options with tabs
├── naughtywp-theme-options.php # Legacy theme options
├── search.php # Search results template
├── single.php # Single post template
├── style.css # Main stylesheet
├── tag-list-template.php # Tags list page template
├── taxonomy-actor.php # Actor taxonomy template
├── views-likes-handler.php # AJAX handler for views and likes
├── assets/ # Theme assets (CSS, JS, icons)
├── inc/ # Include files
└── template-parts/ # Template parts
Theme Setup and Configuration
Initial Setup
After activating the theme and plugin:
Go to "NaughtyWP License" and enter your license key to activate the theme
Visit "Theme Options" to configure theme settings
Create necessary pages using the "Create Pages" section in Theme Options:
- Tags Page
- Categories Page
- Models Page
Required Plugins
NaughtyWP Core (included): Core functionality for the theme including taxonomies, meta boxes, and tools
Theme Options
The theme options panel is organized into several tabs:
General Tab
Logo and Favicon: Upload your site logo and favicon
Thumbnail Settings: Choose between landscape (16:9) or portrait (9:16) orientation
Theme Colors: Customize color scheme elements:
- Body Background
- Secondary Text Color
- Link Color
- Link Hover Color
- Card Background Color
Social Media Links: Add your social media profile URLs
Create Pages: Generate special pages for Tags, Categories, and Models
Homepage Tab
Homepage Settings: Configure the appearance of your homepage
Video Grid: Set the number of videos per page
Homepage SEO Section: Add SEO heading and content for the homepage
Advertisement Tab
Ad Placement: Configure ads in different positions:
- Header Banner
- Footer Banner
- Above Video
- Below Video
Analytics Tab
Analytics Code: Add tracking codes (Google Analytics, Meta Pixel)
Custom JavaScript: Add any custom JavaScript code to your site
Page Templates
Category List Template
The `category-list-template.php` file creates a page that displays all categories with sorting options:
A–Z
Z–A
Most Popular
Tag List Template
The `tag-list-template.php` file creates a page that displays all tags with sorting options:
A–Z
Z–A
Most Popular
Models List Template
The `models-template.php` file creates a page that displays all actors/models with sorting options:
A–Z
Z–A
Most Popular
Custom Post Types and Taxonomies
Taxonomies
Actor/Model: Custom taxonomy for actors or models (`actor`)
Meta Fields
The theme adds the following meta fields to posts:
Video Type: The type of post (blog, video)
Embed Code: For embedding videos from external sources
Video URL: Direct link to video file for self-hosted videos
Featured Video: Option to feature the video on homepage
HD Video: Flag for HD quality videos
Duration: Video duration in seconds
Primary Category: Main category for breadcrumbs and schema
Meta Description: Custom meta description for SEO
Video Management
Adding Videos
Go to Posts > Add New
Fill in the title and description
Set video details in the custom meta box:
- Choose video type (embed code or direct URL)
- Set duration, HD flag, etc.
- Select the primary category
Assign categories, tags, and actors
Upload a thumbnail or featured image
Publish the post
Video Interaction
The theme includes built-in interaction features:
View counting
Like/Dislike functionality
Comments
SEO Features
Schema Markup
The theme automatically adds structured data for:
Video content
Breadcrumbs
Article markup
Meta Tags
Automatic generation of:
Title tags
Meta descriptions
Open Graph tags
Twitter card tags
Customization
Custom meta descriptions per post
Primary category selection
SEO heading and content for homepage
Theme Customization
CSS Customization
The theme uses Bootstrap 5 with custom dark theme variables. You can customize the appearance by:
Modifying the theme colors in Theme Options
Adding custom CSS in your child theme
Templates Customization
Create a child theme and override any of the template files:
`single.php` for single video pages
`index.php` for the homepage
`template-parts/content-video-card.php` for video cards
Optimization Features
Image Optimization
WebP Conversion: The plugin includes a bulk WebP converter tool
Custom Image Sizes: Optimized image sizes for thumbnails
Performance Optimizations
Disabled WordPress emojis
Removed block library CSS
Optimized Bootstrap CSS
Troubleshooting
Common Issues
Videos Not Playing
- Check if the embed code is correctly formatted
- Verify video URL is accessible and in a supported format
Thumbnails Not Showing
- Make sure featured images are set for posts
- Check if image path is correct
Sort Features Not Working
- Verify the custom meta fields are populated correctly
- Check the query parameters in the URL
Support
For support, please contact:
Website: NaughtyWP.com
Email: [email protected]
---
© 2025 NaughtyWP - Powered by WordPress