Documentation

Theme Documentation
Developer Documentation (Login required)

Contents

# 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