ITS Audiobook Platform Help

What is ITS Audiobook Platform?

A complete, multi-tenant audiobook player and e-commerce platform. Sell audiobooks, manage chapters, and provide a premium listening experience to your customers — all from your own branded storefront.

💡 New Here? Start by browsing the Store to discover audiobooks, then use the Player to listen. Sellers can manage everything from the Admin Panel.

Platform Architecture

The platform uses a tokenkey-based multi-tenant system. Each seller gets a unique tokenkey that isolates their audiobooks, orders, and settings from other sellers.

  • Tokenkey: Your unique store identifier (e.g., ab_de3a65bac8344f8c)
  • Buyers: Browse, purchase, and listen to audiobooks
  • Sellers: Upload and manage their own audiobook catalog
  • Admins: Manage all stores and platform settings

Data Storage

The platform uses 8 MySQL tables to manage everything:

TablePurpose
its_audiobooksAudiobook catalog (title, author, price, covers)
its_audiobook_chaptersChapter tracks with audio files
its_audiobook_ordersPurchase records and payment tracking
its_audiobook_licensesUser access control (purchased/free/rental)
its_audiobook_reviewsRatings and reviews
its_audiobook_playbackListening analytics
its_audiobook_seller_settingsPer-seller store configuration
its_audiobook_cartShopping cart persistence

User Roles

RoleCan Do
GuestBrowse store, preview free audiobooks, add to cart
BuyerPurchase, access library, write reviews, track playback
Seller (Role 6)Upload audiobooks, manage chapters, view orders, configure store
Admin (Role 9)Manage all stores, all audiobooks, platform-wide settings

How to Use the Player

  1. Open the Player page with your tokenkey
  2. Browse the Playlist at the bottom and click any track
  3. Click the Play button (large circle) to start listening
  4. Use the progress bar to skip to any part of the track
  5. Adjust volume with the slider or click the speaker icon to mute

Vinyl Record Animation

The spinning vinyl record is a visual indicator that audio is playing. The record spins at a realistic speed and stops when paused. The album cover is displayed in the center of the record.

Playback Speed

Click the Speed indicator below the controls to cycle through speeds: 0.5x → 0.75x → 1x → 1.25x → 1.5x → 1.75x → 2x

Chapters

If an audiobook has multiple chapters, use the Prev/Next Chapter buttons to navigate between them. The current chapter number is displayed.

💡 Tip: Click anywhere on the progress bar to jump to that position. Hover to reveal the drag handle for precise seeking.

Volume & Audio

  • Drag the volume slider to adjust (0-100%)
  • Click the speaker icon to toggle mute
  • If no audio file is found, a soft reference tone (440Hz) plays as fallback
  • Supported formats: MP3, WAV, OGG, M4A, AAC

Browsing the Store

  1. Use Category pills to filter by genre
  2. Use the Search bar to find specific titles or authors
  3. Featured audiobooks appear at the top of the page
  4. Click any audiobook to open it in the Player

Understanding Prices & Badges

BadgeMeaning
FeaturedHighlighted audiobook selected by the seller
FreeCompletely free audiobook — add to library instantly
SaleDiscounted price — original price shown with strikethrough
PremiumPremium content (may require subscription)

Adding to Cart

Click the "Add" or "Add Free" button on any audiobook card. The cart updates instantly via AJAX — no page reload needed. A toast notification confirms the action.

⚠️ Note: Free audiobooks still need to be "added to cart" and checked out (at £0.00) to be added to your library.

Managing Your Cart

  • Change quantity: Type a number in the quantity field — updates automatically
  • Remove item: Click the trash icon next to any item
  • Clear cart: Remove all items individually or complete checkout

Promo Codes

Enter a promo code in the Order Summary sidebar and click "Apply":

CodeDiscountMinimum Order
10OFF£10.00 off£10.00
WELCOME2020% off£5.00

To remove a promo code, click the × next to the applied code.

Payment

  1. Fill in your Name and Email (pre-filled if logged in)
  2. Click "Proceed to Payment"
  3. You'll be redirected to PayPal to complete payment
  4. After payment, your audiobooks appear in your library
💡 Tip: Your cart is saved even if you close the browser. It persists across sessions for logged-in users.

Admin Panel Overview

The admin panel has 3 tabs:

  • Audiobooks: Create, edit, delete audiobooks and manage chapters
  • Orders: View all customer orders with payment status
  • Settings: Configure your store name, PayPal, and commission rate

Adding an Audiobook

  1. Fill in the Add New Audiobook form at the top
  2. Required fields: Title and Author
  3. Set price, category, and other metadata
  4. Upload a Cover Image (JPG, PNG, SVG, WebP supported)
  5. Click "Add Audiobook"
  6. The page reloads in edit mode — now add chapters

Adding Chapters (Audio Files)

  1. Click Edit on any audiobook
  2. Scroll to Chapters section
  3. Fill in: Chapter Number, Title, Duration (seconds)
  4. Click "Choose File" and select your MP3/WAV file
  5. Check "Available as free preview" if this chapter is a sample
  6. Click "Add Chapter"

Bulk Upload

Use the Bulk Upload page to upload multiple MP3 files at once:

  1. Select the target audiobook from the dropdown
  2. Set the starting chapter number
  3. Drag & drop multiple MP3 files or click to select
  4. Click "Upload Files"
  5. Each file becomes a numbered chapter automatically
⚠️ Important: Max upload size is determined by your server's upload_max_filesize setting (typically 128MB). For larger files, use FTP or contact your hosting provider.

Player Keyboard Shortcuts

KeyAction
SpacePlay / Pause
→Skip forward 10 seconds
←Skip backward 10 seconds
↑Volume up (+10%)
↓Volume down (-10%)
NNext track
PPrevious track
SToggle shuffle on/off
RToggle repeat on/off
💡 Tip: Keyboard shortcuts only work when you're not typing in a text field. Click on the player area first if shortcuts aren't responding.

Mouse/Touch Actions

  • Click progress bar: Jump to position
  • Drag progress thumb: Precise seeking
  • Click speaker icon: Mute/unmute
  • Click playlist item: Play that track
  • Click speed label: Cycle playback speeds

Frequently Asked Questions

Q: Why is there no sound when I press play?

A: Check that audio files have been uploaded. If no files exist, the player generates a soft reference tone as fallback. Upload real MP3/WAV files through the Admin Panel or Bulk Upload page.

Q: How do I upload MP3 files?

A: Go to Admin Panel → Edit Audiobook → Chapters → Add Chapter and select your file. Or use Bulk Upload for multiple files at once.

Q: What audio formats are supported?

A: MP3, WAV, OGG, M4A, AAC, WMA, and FLAC. MP3 is recommended for best browser compatibility.

Q: Why are cover images not showing?

A: The system uses local SVG placeholders when no cover is uploaded. Upload a cover image (JPG, PNG, SVG, WebP) in the Admin Panel.

Q: How do promo codes work?

A: Enter 10OFF for £10 off orders over £10, or WELCOME20 for 20% off orders over £5. Apply in the checkout sidebar.

Q: Can I sell audiobooks from my own store?

A: Yes! Every logged-in user gets a unique tokenkey. Use the Admin Panel to add audiobooks, set prices, and manage your store. Payments go through your configured PayPal account.

Q: What is a tokenkey and where do I find mine?

A: Your tokenkey is a unique identifier for your store. Find it in Admin Panel → Stats or Settings. It looks like ab_de3a65bac8344f8c.

Q: How do I reset my audio files if something breaks?

A: Run the audio fixer at /play369/fix-all.php. This regenerates valid WAV files for all chapters.

Q: Is my data secure?

A: Yes. All data is tokenkey-isolated. Audio files are protected from direct PHP execution. Payments are processed externally via PayPal. No card data is stored on the server.

No Audiobooks Available

Start by adding your first audiobook to the library.

Browse Store