Deployment Guide: Ultimate Content Streamer (UCS)

Here is the complete file structure for your plugin and the steps to install it on your WordPress site. This guide is updated to include the "Ad Creatives" feature.

How to Install/Update Your Plugin

Follow these steps exactly to ensure the plugin works and all old files are removed.

Important: Always make a backup of your site before making changes.

Step 1: Access Your Website's Files

Use an FTP client (like FileZilla) or your web host's cPanel File Manager.

Step 2: Navigate to the Plugins Folder

Go to the wp-content/plugins/ directory in your WordPress installation.

Step 3: (CRITICAL) Delete the Old Plugin Folder

If it exists, find the ucs-streamer folder and delete it completely. This is the most common source of errors and will remove all old, conflicting files.

Step 4: Create the New Plugin Folder

Create a new, empty folder named exactly ucs-streamer.

Step 5: Create the Full Folder Structure

Inside your new ucs-streamer folder, create the following sub-folders:

assets

css

js

build

data

includes

templates

Step 6: Create Each File

Now, create every file from the list below in its exact location. The code for each file is in our chat history.

Full File List & Locations (v2.1.1 + Ads)

This is the complete list of all files and their correct folders.

ucs-streamer/
│
├── ucs-streamer.php        (The main plugin file)
├── uninstall.php           (Handles uninstallation)
│
├── assets/
│   ├── css/
│   │   ├── admin-settings.css
│   │   └── player.css
│   └── js/
│       ├── admin-settings.js
│       └── player.js
│
├── build/
│   ├── block.json
│   ├── index.asset.php
│   └── index.js
│
├── data/
│   ├── channel4.csv
│   ├── channels2.csv
│   └── channels3.csv
│
├── includes/
│   ├── class-ucs-admin.php
│   ├── class-ucs-ads.php       <-- (This is the new Ad Creatives file)
│   ├── class-ucs-block.php
│   ├── class-ucs-frontend.php
│   ├── class-ucs-importer.php
│   ├── class-ucs-license.php
│   ├── class-ucs-post-types.php
│   └── class-ucs-preloader.php
│
└── templates/
    └── single-channel.php


Step 7: Activate the Plugin

Once all files are uploaded to the correct folders, go to your WordPress Admin dashboard and navigate to Plugins > Installed Plugins. You should see "Ultimate Content Streamer (UCS)". Click Activate.

Because this is a new activation, the plugin will:

Register all the "Channel" and "Ad Creative" post types.

Flush your permalinks (fixing the 404 error).

Start the one-time background import of all your preloaded channels.
== Frequently Asked Questions ==

Q: Why does the player show "Invalid channel ID" or "Stream URL is missing"?
A: This means the channel was not imported correctly or the M3U/CSV file did not have a valid .m3u8 URL for that channel. Try re-importing or editing the channel manually in the 'UCS Streamer' menu.

Q: Why isn't my paywall working?
A: Check three things:

Is your 'Global Access Mode' set to 'Paid Hard Gating'?

Have you selected a 'WooCommerce Paywall Product' in the settings?

Is WooCommerce installed and active?

Q: Can I import from my own M3U URL?
A: Currently, the M3U importer uses built-in public URLs. For your own private list, the CSV Uploader is the recommended method.

== Changelog ==

= 1.0.1 =

Refactored channel directory to be AJAX-powered for significantly faster page loads.

Optimized frontend script loading to only enqueue (load) video.js on pages that actually contain a player or directory shortcode.

Added ucs_country taxonomy for filtering.

Added robust CSV importer with name, logoUrl, streamUrl, category, country columns.

Improved admin settings UI with product dropdown.

= 1.0.0 =

Initial release.
For any suport issues, reach out to us on https://www.ultimatemultimediaconsult.com/contact or email: ultimatemultimediaconsult@gmail.com, support@ultimatemultimediaconsult.com or WhatsApp +256770730170