Custom Theme? Step One: Consider Customizing an Existing Theme!
Many campus units prefer a more custom look-and-feel for their website, while still complying with University branding guidelines. Often this can be accomplished by using an existing theme on web.unc.edu. This is typically achieved by modifying CSS, using the Custom CSS plugin. For example, the Center for Bioethics , uses a combination of the ‘Responsive’ theme, along with modified CSS, to achieve a unique, professional look-and-feel.
Step Two: Ask Us
We’re always happy to hear new creative uses for web.unc.edu, but we aren’t always able to accommodate new themes. So before you get started on one please contact us at firstname.lastname@example.org.
Step Three: Theme Submission
If you still find you need a custom theme after following steps one and two above you’ll need to make yourself aware of and adhere to the following. Custom themes are accepted for schools, divisions, departments and enterprise programs. These are added to the enterprise WordPress network (sites.unc.edu).
- Sites.unc.edu runs on a WordPress multisite installation. For the most part, theming works exactly the same as a standalone site, especially if you use the latest recommended WordPress functions. The tests below will point out outdated functions and what functions should be used instead.
- We are running a version of PHP that does not allow shortcode php. That means that any short tags like <? will not work, but need to be <?php
- There are a few PHP functions that can not be used on our environment for security reasons. These include (but are not limited to) exec, pass thru, shell_exec, system, popen and proc_open. Most theming won’t have any problems with this, but you should be aware of this limitation if you are trying to doing some very complex php coding. We’d recommend you stick with built in WordPress functions and check with us if you have a question about something specific.
- We usually run one version behind the current version of WordPress unless it is a major release. If you are going to use a function that was just released, please check with us to make sure exactly what version we are running currently.
We have a review process similar to WordPress.org that we follow before any themes are added to the network.
- All themes should be run in debug mode to see if there are any notices that should be resolved.
- All themes should run the WordPress theme check and check to see if there are any required/recommended items that should be resolved.
- All themes should run a VIP scan of the theme and look for any undefined functions that need to be resolved..
- Themes should not be plugin dependent. It is okay to use plugins that we already have available on our network. A plugin must not need to be added to the network in order for the theme to function.
- The department is responsible for keeping the theme up to date and making sure it is compatible with any upcoming releases of WordPress. We will notify all users before a major release. You will need to send us any updates to your theme before we roll the update out into production.
- If at any time your theme is found to have a security vulnerability the theme may be immediately removed and replaced with the default WordPress theme until the vulnerability can be addressed.
Submitting the theme for review:
If you have a theme you are ready to submit for inclusion please email the webdotunc team at email@example.com. Be sure to include the following information:
- Website URL where this theme is going to live.
- Technical Contact (Who is going to responsible for making updates to this theme long term if there is a problem?)
- Affiliated Department
- Affiliated Department Contact
- Link to .zipped theme files (upload to Dropbox or something like that and link to it)
- Any information we may need to know about custom functions, or anything out of the ordinary with your theme.
- If your theme was based on another theme please let us know what theme you used as your basis.
Making updates to your theme:
All updates will need to be submitted to the webdotunc team by emailing firstname.lastname@example.org. Include the following information:
- .zip of all files notdng which files have been updates
- Information about what updates have been made and why
Please allow for up to 3 business days for updates. We prefer a batch of updates at once instead of a bunch of small updates.