navigation

The YouTube Subtitle Explorer is a tool you can install on your server to provide a website to display videos from one of your youtube playlists. Users can then search by languages to find videos that contain or don’t contain subtitles for a particular language. Users can also easily submit caption files that can be then uploaded directly to youtube which makes maintenance very easy.

In the “Your site or hostname” section, unless you have a secure site, change the protocol to http and enter the url to get to the app. (i.e. if your installation is on example.com in the subfolder translations/, you would enter: example.com/translations/ ). Click Continue.

You’ll need to click “more options” in order to specify the “Authorized Redirect URIs” field. Specify it as your homepage with the path login/authenticate/callback (eg: if your installation is on http://example.com in the subfolder translations/, the field should end up being: http://example.com/translations/login/authenticate/callback)

The “Javascript Origins” field should be the top-level (sub)-domain (eg: http://example.com)

SECURITY NOTE: if your system ever becomes comprimised, or you suspect it may be comprimised, the above URLs will allow you to change your client secret and invalidate API keys. This is the first thing you should do if you think someone has hacked your system.

Admin Panel

Simply visit /admin in your web browser to login to the admin panel.

Email Notifications

After you have finished installing the app, you can set up email notifications to be sent when you get a new submission. To do this, visit the admin panel and click on the “settings” tab.

Security

There are .htaccess files with “deny from all” rules in certain sensitive directories. These include:

config/

app/

logs/

user/db/

user/uploads/

user/views/

Whatever you do, ensure that these directories are not accessible by the public and are only accessible by the php application code. (as long as the htaccess files are working that should be taken care of already).

Also, please remember that you shouldn’t share the API keys. If your system ever becomes compromized you can always invalidate the keys through google, and paste any newly created keys into the config/config.yaml file.

Automatic Updates

Once the app is installed, you’ll be notified in the administrator panel if there are updates. Just remember to always backup before updating.

Change Look/Feel

If you have knowledge of HTML/CSS, you can override any of the templates by creating your own in the /user/views directory. Just name your override the same name as you find it in the /app/views directory. Don’t change any code in the /app directory because you will loose those changes if you upgrade.

Views are rendered with the twig templating system. You will need to understand how to write twig templates before you can make any changes.

Creating new templates will let you change almost all markup on the app. This is also how you should include your own css or js files.

Tip: all full-page templates extend the page-skeleton.twig template. So if you override that one, it’s a great place to place your custom css js includes. Feel free to use your own subdirectories in /user to hold your custom js/css.