Installing WS.WebTV Free / WS.WebTV Professional
support, ws.webtv, home, installation
This document has been written assuming that your server meets the requirements of WS.WebTV
Important: Installing WS.WebTV in a folder of a WordPress blog, or any other CMS?
Keep in mind that if you install WS.WebTV in a folder of a Website which already has a CMS installed in its root, you must make sure that any "mod_rewrite" (URL redirection) will not affect the WebTV folder, otherwise WS.WebTV will not work correctly.
1. Download and unzip into temporary folder
First, create a temporary folder in your local drive, with the name (for example) "webtv-files".
- Download the base package file.
- Unzip it with the corresponding password, inside the "webtv-files" folder. After unzipping, you'll find the following folders:
support_files/ (this folder contains sample video files)
www/ (this is the folder that contains the WebTV files)
NOTE: The license agreemen can be found in webtv-files/www/_acuerdo_de_licencia (in Spanish) and webtv-files/www/_license_agreement (in English).
If you have purchased extensions, some of them may require downloading a ZIP file.
- Download the file corresponding to each extension.
- Open each ZIP with the corresponding password.
- Just like the base package, inside each ZIP file you'll find a "www" folder which contains the extension files. Copy the folder "www" inside the "webtv-files" folder you previously created (confirm file overwrite when the operating system asks). The result is that the files of the extension will add to (or overwrite) those of the base package.
If there is any postfixes package available, download it and unzip it inside the "www" folder of "webtv-files", in other words, inside "webtv-files/www" (confirm file overwrite when the operating system asks.
If you have problems unzipping the distribution package try one of the following programs:
• 7-Zip (Freeware)
Mac OS X Users:
The default ZIP utility included in Mac OS X does not support password protected files; therefore, you will need a third party utility to unzip the supplied file. Try one of the following freewares:
• Keka (Freeware)
• Unarchiver (Freeware)
• Rar for Mac
2. Copy files...
Use a FTP program (like FileZilla ) to copy all the files and folders located inside "webtv-files/www", into your Web server's destination folder (do not copy the "www" folder!).
Note: If you are on Mac, beware of Cyberduck as some users have reported file permission issues with the files copied to the server. We recommend using FileZilla instead.
3. Create a new MySQL database
Create a new MySQL database in your server:
Then create/assign the corresponding database's user enabling all available privileges.
Now that you have copied all the files into the server and created a new database, you are ready to install the WebTV:
1. Run the WS.WebTV Installer
...From a Web browser, by visiting: http://your_webtv_url/install. You should see the following screen:
2. Read carefully all the information and instructions.
3. Don't forget to run the Diagnostic tool.
The Diagnostic tool is useful to determine if your server meets the minimun requirements and to get information about other PHP settings.
» PHP Settings
In particular, it is very important that you configure the PHP settings detailed below, according to your needs.
- Setting adjustments are normally done in your server's .user.ini, php.ini or .htaccess file (some times you will need to create the appropriate file). In case of doubt consult with your hosting company or server administrator.
- Some hosting companies (depending on the hosting plan) may limit the maximum values or even not allow to change them at all. Again, in case of doubt consult with your hosting company or server administrator.
- These settings not only affect WS.WebTV, they also afftect ANY other PHP application that deals with file uploads or with process which require long execution times.
"upload_max_filesize" and "post_max_size"
Limit the size of the uploaded files. If a file is bigger than the value specified in this setting, it will fail to upload. Example settings:
(Allow uploading files up to 2000MB in size.)
upload_max_filesize = 2000M
post_max_size = 2000M
"max_input_time" and "max_execution_time"
Limit the execution time as well as the time a file can take to upload. If a file takes longer than the time specified in this setting, it will fail to upload. Example settings:
(Allow uploading files which take up to 6000 seconds - 1.67 hours - to upload.)
max_input_time = 6000
max_execution_time = 6000
Limits the amount of memory that a PHP application/script can use during its execution. This setting is important for image processing; if it is set very low (for example, 32M) then the WebTV will not be able to resize some of the uploaded images which have a reasonable size. Example setting:
(The following setting should be enough in most cases)
memory_limit = 64M
To prevent that any execution error be visible to the WebTV visitors, set it to "Off" (recommended).
display_errors = Off
NOTE: There are also several other configuration option in your Web server configuration which could cause issues with the upload of large files. Please read the "TROUBLESHOOTING" section at the bottom of the page for more information.
4. Click "I accept, Start" when ready.
The Database setup screen will appear...
Enter the appropriate database info. Then click Continue.
5. Once the database is installed, the next step is to supply the license key and the basic configuration information.
Fill in the required fields and click Continue.
Regarding Base URL:
Base URL must match exactly the URL you provided when you filled in the purchase form.
Regarding notification E-Mail messages:
In case your server is not able to send mails using the PHP mail sending functionality (WebTV default), you can configure the WebTV to use a SMTP account instead. For more info read the "TROUBLESHOOTING" section of this document.
Regarding the master password:
This option has been removed from the installer since WS.WebTV 2.4. Since this version, the master password must be set from the Configuration > General section of the Content Administrator.
6. Installation is complete...
• If you need to modify the database connection information, Base URL, etc. you can edit the WebTV configuration file located in config/Config.inc.php
• (Since WS.WebTV 2.4) In the config/ folder, it must have been generated a file with random name and .pek extension. "pek" means "partial encryption key"; it is "partial" because its content is used, along other information, as key to encrypt data before being stored into the database and to decrypt data which have been stored encrypted in the database. This file is unique for each WebTV and if it get lost or damaged it won't be possible to decrypt data which is stored encrypted in the database.
• We strongly recommend you to make periodic backups. Read the tutorial here.
7. Logging in for the first time.
Without leaving the previous screen, click on "Log In" to access the Content Administration Interface.
NOTE: You can also log into your WebTV by visiting: http://your_webtv_url/admin.
When you purchase extensions, besides copying the corresponding files to the server, it will be necessary to enter a new license key. In order to do this, go to Go to Configuration > General Tab.
Enter the license key into the appropriate field. Then Save the Configuration.
WS.WebTV includes a pre-made robots.txt file, disallowing search engine indexing of several files and folders. Additionally, in this file should be specified the sitemaps for your Website. Since version 22.214.171.124, the installer script takes care of generating the file with the necessary information, but it is worth verifying its content and location:
The last two directives of the file contain the references to your WebTV' sitemaps:
Sitemap: /sitemap.php # use an absolute URL here. Example http://www.url_of_your_webtv.../sitemap.php
Sitemap: /videositemap.php # use an absolute URL here. Example http://www.url_of_your_webtv.../videositemap.php
NOTE: The robots.txt will only work when it is in the root of a domain. If your WebTV is installed inside of a folder, it will be ignored by the search engines.
If your server includes FFmpeg support, you can configure WS.WebTV to compress videos. Check the following video encoding configuration tutorial for more information. If your WebTV is installed inside a folder of the domain, the file will be ignored by search engines; in this case, you must include the directives corresponding to your WebTV inside the robots.txt file which is in the domain root.
WS.WebTV supports Friendly URLs. By default it uses the "standard" generation style. Example:
http://mywebtvdomain.com/index.php/video/1/trailer (note the index.php in between)
The "standard" style should work on any server.
Although the previous, there are other options available:
1. Folder style. Example:
2. File stytle. Example:
3. Disabled. You can also disable Friendly URLs. Example:
Changing the Friendly URLs options:
Edit the WebTV configuration file (config/Config.inc.php) file and look for the corresponding section:
// ---------- FRIENDLY URLS ----------
$FRIENDLY_URLS_ENABLED = true; // Ops: true / false. Enable/disable Friendly URLS.
$FRIENDLY_URLS_STYLE = "default"; // Ops: "default" / "folder" / "file"
"URL Rewrite" required...
Please, note that "folder" and "file" styles require the mod_rewrite Apache module, and .htaccess file modification.
» Download .htaccess rewrite rules for "folder" style
» Download .htaccess rewrite ruler for "file" style