01Before you start
Members CMS runs on your own web server, and each of your websites gets its content through a small connector. Check that your hosting has:
| Requirement | Why it's needed |
|---|---|
| PHP 8.1 or newer (8.2 or 8.3 recommended) | Runs Members CMS. Extensions: pdo_mysql, mbstring, fileinfo, json, dom, openssl, and gd or imagick |
| MySQL 5.7.8+ / 8.x or MariaDB 10.3+ | Stores your library, websites, statistics and settings |
| Apache (with .htaccess) or Nginx | Serves the admin area |
| HTTPS (strongly recommended) | Protects your sign-in and media links |
| Optional: zip, exif and curl extensions | DOCX import and media backups, photo rotation, license activation |
| Optional: FFmpeg and FFprobe | Video posters, video duration and codec, browser-playable copies |
| Optional: ImageMagick | Very large images and HEIC, TIFF, AVIF and BMP thumbnails |
| A cron job | Runs drip schedules and timed offer expiry on time; also background processing and scheduled backups |
| Each website: PHP 7.2 or newer | Runs the connector, on the same server or a different one |
Disk space: your original media, plus roughly 5-10% for thumbnails and previews, plus room for backups.
Drip schedules and timed offers need the cron job, because releases are never triggered by page visits. Thumbnail processing can also run while an administrator has the admin area open (Settings > Upload).
02Installing Members CMS
- Create an empty MySQL or MariaDB database and a user with all privileges on it - for example with cPanel's MySQL Database Wizard, or in phpMyAdmin. The setup guide in the ZIP also has a command-line script.
- Upload and extract the Members CMS ZIP into the folder your domain or subdomain points to (for example
cms.yourdomain.com). - Open
install.phpin your browser. It has six steps: server check, database, site and storage folder, owner account, license key, and install. It imports the MySQL schema for you; if you have already importedinstall/schema.sqlby hand, it simply uses those tables. - Choose a storage folder outside the public web folder if you can (the installer suggests one), so originals can only be reached through Members CMS.
- Enter your license key at the license step, or later in Settings > License.
- Add the cron line shown in the setup guide (in cPanel: Cron Jobs). It runs drip schedules, timed offer expiry, background processing and scheduled backups.
The installer locks itself when it has finished.
03The dashboard
The Dashboard shows live figures from your library and websites. The sidebar is organised as Media Library, Stories, Categories, Websites, Content Drip, Members Areas, Promotions, Maintenance and Settings.
04Uploading media
Go to Media Library > Upload Folders. Drag one or more folders onto the page, or click to choose them. Every folder becomes one media set.
- Images: JPG, JPEG, PNG, WebP, GIF, AVIF, BMP, TIFF and HEIC (AVIF, BMP, TIFF and HEIC thumbnails need ImageMagick).
- Videos: MP4, MOV, WebM, M4V, MKV, AVI, WMV, MPG/MPEG, OGV and 3GP. Videos browsers can't play get an MP4 copy for previews when FFmpeg is installed; the original is always kept.
- Resumable: files are sent in chunks, several at a time, with per-file and overall progress. Pause and resume, and retry failed files with one click.
- Checks: each file's real type is checked (a disguised script is rejected) and names are made safe. Duplicates are skipped according to your choice in Settings > Upload.
- Storage: originals are stored as uploaded (unless you switch on image size reduction, section 6), and each set gets its own folder named by a permanent ID, such as
set-000418. The original folder name is saved separately, and renaming the set never moves files.
Large batches: add approved server folders in Settings > Upload, copy files there by FTP or SFTP, then use Maintenance > Server Folder Import.
Thumbnails, previews, video posters and video details are made in the background, and sideways phone photos are turned upright. New sets start as Draft; only Published sets reach your websites.
05The media library and galleries
Media Library > All Media Sets shows every set in a grid or list. Search, filter by status, category, media type, orientation or date, sort, and choose 12, 24, 48 or 96 per page - your choices are remembered.
Editing a set
Open a set to edit its title, description, snippet (a short text for small spaces - if left empty, the start of the description is used), categories and status. Choose the cover with the star (it turns red), reorder files by dragging, add, replace or delete files, and switch Show on tour on or off. On individual images, Use on tour picks the photos your tour should prefer. The set also shows which websites it reaches. Deleted sets go to the Trash and can be restored.
Galleries
Each set's gallery has grid, masonry and list layouts and a portrait/landscape filter (square images are handled as you choose in Settings > Gallery). The lightbox supports the keyboard, swiping, zoom to full resolution, fullscreen and video playback, and shows each file's details with a download button.
Bulk actions
Select several sets to add or remove categories, change status, archive, move to the Trash, regenerate thumbnails or export their details as CSV or JSON.
06Focus points and image size
Focus points. Tour pages and members areas crop photos into wide and tall frames. Every image gets a focus point - guessed automatically, aiming at the subject's head - and cropping keeps that point in view. To set it yourself, open the photo in the lightbox, press the crosshair button and click the spot.
Image size reduction is optional (Settings > Upload). Set minimum and maximum width and height, quality, output format and whether to strip metadata. A reduced image only replaces the stored one when it is actually smaller.
07Stories
Use Stories > Add New Story to write a story with a title, summary, body and categories. The editor has headings, chapters, bold, italic, lists, quotes and links, and you can insert images and videos from your library (by reference, so nothing is copied). Paste from Word or a web page and the formatting is cleaned up. Stories autosave, can be previewed, and keep a revision history you can restore from.
Import existing writing from TXT or DOCX files with Stories > Import Stories. Stories can be linked to media sets, duplicated, archived or moved to the Trash.
08Categories
Categories are flat: no parent and child categories, nothing inherited. If a set shows puppies learning a trick in an obedience class, tick Dogs, Puppies, Obedience and Tricks.
- Categories > Manage Categories: create, rename, merge and delete unused categories, see usage counts, and arrange them in optional visual groups (groups never change matching).
- Categories > Bulk Categorisation: add or remove categories on many sets or stories at once.
09Websites and category matching
Add each website under Websites > Add Website, then choose:
- Categories the site is about, and excluded categories that must never appear on it.
- Matching mode and filler settings (below), the content types it shows (sets, stories), and the page size and order.
- Drip settings (sections 10-13) and members area and tour settings (sections 14-17).
| Mode | What qualifies | Good for |
|---|---|---|
| Match ALL | Content with every selected category (extra categories are fine) | Focused niche sites |
| Match ANY | Content with at least one selected category | Broad sites |
| Preferred + Filler | Exact matches first, then partial matches ranked by how many categories they share | Niche sites that need topping up |
For Preferred + Filler, set the minimum number of matching categories and the maximum filler percentage, worked out across the whole list. Exact matches always come first and nothing is repeated to fill a page. The live preview on the website form updates as you tick categories, and Websites > Content Preview shows the full paginated list.
10Content drip schedules
Open a website's Drip Settings (or Content Drip > Release Schedules) to set a separate schedule for each content type: image sets, individual images (optional), videos, stories, upsells and cross-sells. For each one choose:
- on or off, and how many items per release;
- every X days, weeks, months or years, the release time and the website's time zone;
- the start date, minimum reserve, rotation and cooldown, and what to do when there's a shortage.
Example for a site called Puppy Obedience Club: image sets 5 every 2 days at 09:00, videos 2 every week at 12:00, stories 1 every 3 days at 18:00, upsells 2 every 7 days at 10:00, cross-sells 4 every 14 days at 08:00.
Releases run from the server cron job, never from page visits, so the cron job is required once you use schedules. Times are stored in UTC and planned in the website's time zone, so a 09:00 release stays at 09:00 when the clocks change. Monthly releases on the 29th, 30th or 31st run on the last day of shorter months. Each release appears in that website's members area and on its tour through the connector.
Image sets or individual images? By default, "5 image sets" means five complete galleries. If you turn on individual image dripping, Members CMS tracks exactly which files of each set have been released to each website, and unreleased files stay hidden.
Drip status is separate from publication status: a Published set can be live on one website and still waiting in another website's reserve.
11Reserves and launching a website
Each website keeps a protected reserve for each content type, for example 20 image sets, 10 videos and 5 stories. A scheduled release won't take the site's unreleased content below its reserve unless you choose to override it, and any shortage is reported on the dashboard and in Content Drip > Content Reserves.
Every item's state is tracked per website: eligible, reserved, scheduled, released, in rotation or excluded. When you upload and categorise new content, Members CMS checks it against every website automatically.
Initial content for a new website
When you add a website you can give it an initial allocation, such as 40 image sets, 10 videos and 8 stories, with a reserve kept behind it. Members CMS shows whether enough eligible content exists before you confirm. The initial release can happen straight away or at a launch date and time. Turning on dripping never releases all of your eligible content at once.
12Content rotation
Under Content Drip > Rotation Settings, choose one of two modes for each website:
- Archive + Feature rotation: released content stays in the site's archive and can later reappear in a featured or updates section.
- Limited Active Catalogue: released content can leave the active catalogue and be released again later.
Then set the minimum cooldown, oldest last-featured first, the maximum repeat frequency, whether rotation happens only when new content is short or alongside new releases, and the maximum active window. Files are never moved or copied, original dates are never overwritten, and release and re-feature dates are kept separately so recycled content is never presented as new.
13Release queue, history and forecast
- Upcoming Releases and Release Queue show what will be released, when and from which content.
- Release History records the website, content type, schedule, planned and actual time, requested and released quantity, the items released, exact match or filler, first release or rotation, the outcome and any errors.
- Manual Releases lets you release now, following the same rules. You can also pause and resume schedules.
- Failed Releases lists anything that didn't complete, ready to retry.
Each release is locked while it runs and recorded once, so it can never run twice. Under Settings > Scheduling choose what happens to releases missed while the server was down: run the latest missed release, catch up missed releases within a limit, or skip them. A problem on one website never holds up the others.
Content Forecast
Content Drip > Content Forecast shows, for every website and content type, the eligible, released and unreleased content, the protected reserve, the schedule, the estimated runway and the date a shortage is expected, with and without rotation. For example: 120 unreleased image sets, 20 kept in reserve and 10 released a week leaves 100 to release, about 10 weeks. Forecasts are estimates and change as you add content or change schedules.
14The connector and members areas
- Open Members Areas > Connector Management and download the connector for the website. Its settings file is already filled in with that site's address and credentials.
- Upload the
membersfiles into the site's members folder (the site needs PHP 7.2 or newer). Upload thetourfiles too if you want the ready tour pages (section 16). - Log in to the members area and open
members/mcms/check.php. It checks the PHP version, the settings file, the cache folder, the connection to Members CMS and whether both servers' clocks agree, whether your login is recognised, and whether there is content to show.
The members area includes a members home page with the newest updates, galleries and gallery pages, movies and movie pages, and stories and story pages. Change the logo and colours in templates/theme.php and the page layouts in templates/. The templates folder is yours: updates never overwrite it.
15Media delivery and member logins
Delivery mode (per website)
- Different server: pictures and videos load from Members CMS through signed links that expire.
- This server: when the website is on the same server, the connector streams files straight from the storage folder using signed tokens.
Either way, nothing is copied to the website. Every request between a site and Members CMS is signed with that site's own credentials.
Member login (per website)
Members keep logging in exactly as they do now, whichever billing processor you use - CCBill, Epoch, Segpay, Verotel, NATS, PayPal and many others. Choose how the connector recognises them:
- a password-protected folder, as set up by processors such as CCBill, Epoch, Segpay and Verotel and by NATS;
- a PHP session (you give the session key and name) - the usual choice for members scripts that take payments through PayPal;
- a cookie, a server variable or a custom function;
- or none.
Require login can only be switched on with a password folder, a session or a custom function, because cookies and server variables can be faked. Usernames never reach Members CMS: the site sends only a one-way code.
Members CMS does not create member accounts or take payments. Those stay with your billing processor or members script.
16Tour pages
The tour files give each website a public tour that updates itself: the newest tour content appears automatically, using preview-size pictures only, so full sets stay in the members area. Only sets with Show on tour switched on are used. Already have a tour? Use the updates snippet instead.
- Header: one picture per set, using each set's cover. It changes on every visit, or tick Same header photos on every page for the same pictures everywhere, with a new choice each day.
- Featured updates show the full description, with layouts that alternate between wide and tall frames and photos fitted around their focus points.
- Preview collections grid: choose how many sets to show (default 21, 0 hides it) and the order - newest first, or most popular with members over the last 30 days.
- Separate switches show or hide categories and photo/movie counts under each description.
These settings are in Websites > Edit > Members area & tour > Tour pages. All the tour wording, the number of models per page and the join settings are in the site's tour-config.php. The header and footer logos link to the website's home address.
An optional adults-only warning box with your legal links can end every tour page. Its "leave" link goes to one address shared by all your sites, set in Settings > Members Area > Tour pages, together with the trademark owner shown under it.
17Set previews, More Models and the join page
- Set preview pages (
preview.php): up to 6 larger preview pictures - the ones used on the tour first, then others from the set - with the full description, a "just a taster" note and Join and More Previews buttons. Every picture links to the join page. Stories go straight to the join page. - More Models (
models.php): every tour set, newest first, as portrait thumbnails of each set's cover, 24 per page. - Join page (
join/): the tour's design with a benefits list and a plan and price card. Visitors enter and confirm their email and tick the age and terms boxes, then go to your billing processor's checkout with their email filled in. Set the checkout address, plan, price and wording intour-config.php. No card details are ever taken on your site; until a checkout address is set, the page shows a "not connected" note.
18Statistics
Members Areas > Statistics shows gallery opens, photo views, movie plays and how much of each movie is watched, story reads and completions, downloads and unique members, for each website. Popular Content lists your most-opened sets, stories and photos, and category demand shown as views per item, so popular categories aren't simply the ones you post most. Export figures as CSV.
Members are counted by a one-way code made on the website, so usernames are never stored, and visitors without a cookie aren't counted.
19Promotions
Members Areas > Promotions shows cross-sells, upsells and offers inside your members areas. Each promotion has:
- a type (cross-sell, upsell or offer), a title, an image from your library and a link;
- where on the page it appears, and which websites and categories it suits;
- start and end dates (the end date is included), and its own drip schedule if you want promotions released gradually;
- a priority and a weight - higher weights are shown more often when several promotions could appear in the same place.
- optional timed offer details and conflict groups (section 20).
A cross-sell is never shown on the site it promotes. The list shows views, clicks and click rate for each promotion; count sales with your billing processor's reports.
20Timed offers and promotional rules
Timed offers
Under Promotions > Timed Offers, give an upsell or cross-sell a real start and expiry date and time with a time zone, an optional offer price, comparison price or discount, a countdown, a priority and an optional repeat (one-time, or every X days, weeks, months or years). When an offer expires it stops being selected, the expiry is recorded and an eligible replacement can take its place. Expired offers can't come back through rotation, and countdowns always show the real time left.
Your shop or billing processor must still check the price and whether the offer is valid at checkout. Members CMS never resets a countdown or invents scarcity.
Promotional rules
- Conflict Groups: put mutually exclusive promotions in a group; only one from the group appears in a placement.
- Promotional Rules: website and category exclusions, placement restrictions, cooldowns, minimum relevance, priority and self-promotion exclusions.
- Promotional Rotation: rotate upsells and cross-sells independently, for example 2 upsells every 7 days and 4 cross-sells every 14 days, sorted by highest priority, most relevant, oldest last displayed, random or weighted. A placement never shows the same promotion twice.
Rules about products a member already owns only apply once real membership information is connected; Members CMS never invents it.
21Maintenance and backups
- Storage Overview: space used by originals, previews, backups and the Trash, the largest sets, and which server tools (image library, FFmpeg) were found.
- Integrity Checking: finds missing, orphaned, changed and duplicate files, verifies checksums and quarantines problem files.
- Thumbnail Regeneration and the Processing Queue, with retries for failed jobs.
- Backup and Restore: database and media backups that can be verified and restored, and scheduled with cron. Keep a copy away from the server too.
- Activity Logs: who changed what and when, plus the error log.
22Security
Passwords are stored with strong hashing, sign-in attempts are rate limited and sessions expire after inactivity and after a maximum time. Two-step sign-in with an authenticator app and recovery codes can be optional or required (Settings > Security). Every form is protected against cross-site requests, a strict content security policy is used, and there are owner, admin and editor roles (Settings > Administrators). Media is only ever served through access-checked links. Always use the admin area over HTTPS.
23Updating
Upload the new version over the old files, but keep config/config.php, config/installed.lock and your storage folder, and don't upload install.php again. The database updates itself the first time you open the admin area. On your websites, replace the connector's members/mcms/ files and the tour files as described in the release notes, but keep your own templates/, members/mcms/config.php and your edited tour-config.php wording.
24Your license
One license covers one Members CMS installation on one domain, and that installation can manage an unlimited number of websites. Enter the key in the installer or in Settings > License, which also shows the license server's last reply. Test copies on localhost or a .test address always work fully and don't use the activation.
A new key has a 7-day grace period, and a license server that can't be reached never switches off a working copy. Without a valid key on a live domain, Members CMS becomes read-only (you can still browse, export and back up) and your websites receive no content until a key is entered.
Lost your key or download? Use the re-download page. For anything else, contact support.
