Applicable for version 2.2.500+
Plugin template files are available in the:
Each module (skins or winners, etc) has its own directory with templates, respectively “skins”, “winners”, “leaders”, “contests_list”. Every file starts with a short documentation along with a list of variables available in this template.
Example 1 (php)
If you wish to modify one of php template files, here is the correct way to do it.
Go to your WordPress Theme (for example “twentyten”) directory,
wp-content/themes/twentyten and create a
wp-foto-vote directory here. Next, let’s assume we want to modify “Single Competitor View” page in “Pinterest” skin. The original template for this file is located in
So need to create the folder called
skins/pinterest and copy there file
Now, as a template for “Single Competitor View” page, WP Foto Vote will use the following file:
The reason for creating the new file instead of modifying the original file is that once you update WP Foto Vote you would lose all modification you made.
Example 2 (css)
If you wish to modify one of css template files you can follow 3 ways:
- Override this CSS file (for big changes, else after update some styles for new elements can be missed)
- Add custom CSS file where override original styles (medium changes)
- For small changes use Custom CSS section [Photo Contest => Settings => Custom CSS (at the bottom of page)]
If you selected first way – “Override this CSS file” then follow Example 1:
Let’s assume we want to modify “Single Competitor View” page styles in “Pinterest” skin.
The original template for this file is located in
wp-foto-vote/templates/skins/pinterest/public_item_tpl.css. So create folders called
wp-foto-vote/skins/pinterest in a
twentyten theme folder and copy there file public_item_tpl.css.
Now a CSS for “Single Competitor View” page will be loaded from
Can I copy all Skin files and modify them in my theme folder?
Yes, but I recommend copy file that you really need customize (if there no suitable hooks/filters).
Because template files are frequently updated (new features, improvements) and you can miss new things.
Also if you copy just CSS file (
public_item_tpl.css but do not copy
single_item.php) after future updates your layout can be broken because of css classes & layout changes.
How template file is searched?
For the first plugin calls WordPress function,
locate_template that check is file exists in Child theme & Main WP theme and returns its path.
If nothing was found – default template has been loaded from plugin templates folder.
Last updated: 25 April 2017