Skip to main content

Getting Started with RetroTube

This page takes a fresh WordPress install to a working tube site. Budget about twenty minutes, most of it spent waiting for WordPress rather than on RetroTube itself.

Here is what you are building.

The RetroTube homepage

1. Before you start​

RetroTube is a WordPress theme, so you need a WordPress site first: a domain, a host, and WordPress installed on it. If you are not there yet, start with Getting Started.

2. 1. Install WP-Script Core​

Every WP-Script product is activated through the WP-Script Core plugin, so install it before the theme itself: How to install WP-Script Core.

Once it is active, activate your site with your site key: Site key activation.

3. 2. Install the theme​

Download the RetroTube zip from your account, then in WordPress go to Appearance → Themes → Add New → Upload Theme, choose the zip and activate it. The full walkthrough is in How to install a WP-Script theme.

Upload the zip, do not unzip it

WordPress expects the archive itself. Uploading an unzipped folder over FTP works too, but it has to land in wp-content/themes/retrotube/, with style.css directly inside it.

4. 3. What activation does for you​

RetroTube creates five pages on its first activation, each with its template already assigned: Categories, Tags, Actors, Submit a video and My Profile. It also builds a main menu and fills the four widget areas with a working set of widgets.

The pages are tracked by the theme, not by their title or slug, so renaming one never makes the theme create a duplicate. To see which page plays which role, open the Pages tab of the Theme Options.

One thing it does not do: the permalinks. Go to Settings → Permalinks and choose anything other than the default. The category, tag and actor archives, the photo galleries and the blog all rely on pretty permalinks: on the default ?p=123 setting they return a 404.

No Blog page to create

The blog is shown at its own address, /blog/ by default, so there is no page to create for it. Older versions had a Create Blog page tool: it is gone, because that page could never be displayed. Add the blog to your menu as a custom link to /blog/ if you want it there.

5. 4. Pick a look​

RetroTube's settings live in their own admin page, RetroTube in the WordPress menu, not in the Customizer.

Two decisions are worth making before anything else, both in Visual options:

  • Flat or gradient. Gradient is the older tube look this theme is named after, flat is the modern one.
  • The main colour, used for links, buttons, the rating bar and the player.

If you would rather start from something finished, the Niches tab loads a complete set of options in one click. Do it now rather than later: importing a niche overwrites every setting on every tab.

At RetroTube → Logo & Favicon. You can have the theme build one from an icon and a line of text, or upload an image and give it a maximum width. The favicon is set in the same place. A Site Icon set at Appearance → Customize → Site Identity takes over from it, so use one or the other.

7. 6. Add your first video​

Videos are ordinary WordPress posts with the video post format:

  1. Go to Posts → Add New.
  2. Set the post format to Video.
  3. Fill the video fields in the RetroTube - Video information box below the editor. Every field is covered in Video Information.
  4. Assign a category, some tags, and one or more actors.
  5. Publish.

Repeat a handful of times so the homepage has something to show. Bulk importing from tube sites is what WPS Mass Embedder is for.

A published video looks like this:

A RetroTube video page

Your categories and actors get their own pages, built from the same videos:

A RetroTube category page

And the same site on a phone, which is where most of a tube's traffic comes from:

RetroTube on a phone

8. 7. Make it yours​

Once there is content on the site, go through these in order:

  • General for how many videos a page holds and which systems are on
  • Videos, formerly the Content tab, for the homepage (carousel, video blocks, SEO text), the video page and the category, tag and actor pages. Each kind of page has a list part (the page that lists them all) and a page part (one category, one tag, one actor), with its slug and its options. See Options.
  • Advertising for the ad zones
  • Mobile, which is a separate set of settings and the one most people forget
  • Pages to choose the page used for each part of the theme, recreate a missing one, or change its slug
  • Tools for the Create the menu and Create the widgets buttons. Each one says what it will do and shows what your site already has. Create the widgets only fills the widget areas that are empty: it never removes or replaces a widget, your ad widgets included.

9. 8. Your language, and your visitors' texts​

RetroTube is translated into English, German, Spanish, French, Hindi, Italian, Portuguese and Russian, and the two sides of the site follow two different settings:

  • Your visitors see the theme in the language of the site, set at Settings → General → Site Language.
  • The admin, Theme Options included, follows the language of your own profile, at Users → Profile → Language. You can run a French site from an admin in German, and each admin user can pick their own.

The Texts tab of the Theme Options explains the same thing and links to both screens.

To change a text your visitors see (a menu label, a button, a message), open Appearance → Customize → Texts. A pencil appears next to every text you can change in the live preview: click it, type your text, and see it replaced as you type. A field left empty keeps the translated text of the site language, shown in grey. Keep the codes of the original text, like %s or %1$s: they are replaced by a number, a name or a link, and a text missing one is ignored.

10. Where to go next​

  • Options documents every setting the theme has.
  • Widgets covers the four widget areas and the video blocks that fill them.
  • FAQ answers what people ask most often.
  • Troubleshooting is where to look when something does not appear.