osTube 2.3 changes the way templates are handled. The new template system is easier to maintain while also being easier to change.
This document will give you some insight on how to convert your template to the new format. Please refer to the appropriate scenario for information on how to update your template.
If you are not sure what scenario affects you, simply go to the update page at http://www.yourdomain.com/install/update.php. It will tell you if you have made any modifications to the templates.
Changes to the template system
The new template system consists of a template and a style set. The template defines the HTML code, while the style defines the actual colors and images to be used. All default osTube templates are now grouped into the new "default" template, with the old template name being the new style name. This allows for easier modifications among different styles.
Furthermore, the old color selection in the administration area is gone. Instead you can specify additional CSS code to quickly change the way your page looks, without having to modify the actual style or template. These changes will be retained when you update osTube the next time.
Inside your templates folder you will only find a single folder named "default". This folder again contains a subfolder named "styles" where the actual styles (default, hightek, black mamba, etc.) are present.
Default template, unmodified
If you are using one of osTube's default templates and you have not modified it, simply delete the old templates folder and copy the new one to the server. Then, visit the update page at http://www.yourdomain.com/install/update.php. You will be shown a warning that you have modified your style, but the installer will take care of the installation.
Default template, modified
If you are using one of osTube's default templates and you have modified it, you have to merge the changes into the new structure.
First, rename the templates folder to something like templates_old. Then, upload the template folder that was provided with the update package. Finally, you can copy the modified files to the new folder. What you have to copy depends on what you have changed:
- If you have modified the actual HTML files (i.e. content/mediadetails.tpl), copy the file from the old folder into the new "default" template folder. Note that some template files have changed because of new features or bugfixes, so be careful not to overwrite those changes.
- If you have modified the stylesheet, simply copy the style definitions from your styles.tpl file to the styles.css file in the folder for the style you are using.
For example, if you have modified the hightek style, copy the changes from /templates_old/hightek/styles.tpl to /templates/default/styles/hightek/styles.css. - Do the update at http://www.yourdomain.com/install/update.php
Custom template
For easier reading, let's assume your template name is myTemplate.
- Delete all folders from your templates directory, except your custom template.
- Copy the contents of the templates folder provided in the update package to the templates folder.
- Go inside the /templates/myTemplate directory and create a directory called styles and inside that directory create another directory called myTemplate.
- Copy the images folder from /templates/myTemplate to /templates/myTemplate/styles/myTemplate
- Copy the following files from your /templates/myTemplate directory to /templates/myTemplate/styles/myTemplate: admin.css, admin_pro.css, ads.css. Don't worry if you can't find all files, it depends on the osTube edition you have installed.
- Copy the styles.tpl and styles_ie.tpl files from your /templates/myTemplate directory to the /templates/myTemplate/styles/myTemplate folder, and rename them to styles.css and styles_ie.css respectively.
- Do the update at http://www.yourdomain.com/install/update.php