Skip to content


Subversion checkout URL

You can clone with
Download ZIP
WordPress Theme Oenology
PHP CSS JavaScript

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


=== Oenology ===
Contributors: Chip Bennett
Donate link:
Tags: fixed-width, white, black, blue, red, tan, green, one-column, two-columns, three-columns, custom-header, custom-background, custom-menu, editor-style, featured-images, flexible-width, full-width-template, left-sidebar, post-formats, right-sidebar, sticky-post, theme-options, threaded-comments, translation-ready
Requires at least: 3.5
Tested up to: 3.8.1
Stable tag: 3.3

Description: Oenology is designed to be a simple, minimalist, yet feature-complete and fully documented Theme intended to serve as a base for child Themes and as an educational reference for Theme development using WordPress functions, action/filter hooks, and template tags. Oenology includes built-in breadcrumb navigation, and supports the Theme Customizer, Contextual Help, Post Formats, Navigation Menus, Post Thumbnails, Custom Backgrounds, Custom Image Headers, and Custom Editor Style. Oenology features a responsive design, and includes plug-and-play support for the WP-Paginate and Yoast Breadcrumbs plugins. <strong>Requires WordPress 3.5, and is compatible up to WordPress 3.6.</strong>

== Description ==

Oenology is the study of all aspects of wine-making. Much like wine-making, WordPress Theme development is both a science and an art. 

Much like wine-making, WordPress Theme development is the result of a fermentation process that transforms something simple into something beautiful and complex. Much like wine-making, WordPress Theme development involves an understanding of both the "indoor" (the back-end data management) and the "outdoor" (website design) elements of the process. Much like a fine wine, a great WordPress Theme is often the result of years of study by a passionate developer.

Oenology doesn't purport to be a fine wine or even a great WordPress Theme. Rather, Oenology is designed to help others learn the art and science of WordPress Theme development.  

Consider Oenology as the fertile soil from which your own enjoyment and passion for WordPress Theme development can grow.

You, too, can become an Oenologist!

== Installation ==

Manual installation:

1. Upload the `oenology` folder to the `/wp-content/themes/` directory

Installation using "Add New Theme"

1. From your Admin UI (Dashboard), use the menu to select Themes -> Add New
2. Search for 'oenology'
3. Click the 'Install' button to open the theme's repository listing
4. Click the 'Install' button

Activiation and Use

1. Activate the Theme through the 'Themes' menu in WordPress
2. See Appearance -> Oenology Options for Theme Options

== Frequently Asked Questions ==

= So, how do I learn from Oenology? =

Each Theme template file includes a considerable amount of inline documentation, explaining the code use. 
Also, the Theme includes a function reference, that lists each function, hook, and tag used in the Theme, along with a WordPress Codex reference, an explanation of the function, and example usage.

= What is the Oenology Reference admin page? =

The Oenology Reference admin page contains the latest updates to general Theme notes, the FAQ, Changelog, License,
 and, perhaps most importantly, the Code Reference.

The Code Reference tab of the Oenology Reference page now replaces the "oenology-reference.txt" file, as
 the master cross-reference file, that contains all of the functions, template tags, and hooks used in the Theme

= What happened to oenology-reference.txt? =

oenology-reference.txt has been replaced by the "Code Reference" Tab of the "Oenology Reference" admin page. 
See Dashboard -> Appearance -> Oenology Reference -> Code Reference.

= Why so many template files? =

Oenology is likely broken down into more template parts than the average Theme. This deconstruction is by design, in order to facilitate easier Child-Theming.

= What's in store for the future? =

First and foremost, since Oenology is intended to be a learning tool, the inline and reference documentation will be a continual work-in-progress, based upon user feedback. This documentation is complete as of Oenology Version 1.0, but will continue to be updated and improved.

Other features that may be added in the future:

 - Others, as determined by user feedback and demand

= What About SEO? =
I am a firm believer that the single, most important criterion for SEO is good content. That said, the Theme does take apply some SEO considerations:

1. The Theme assumes that the H1 heading tag will only be applied to the Post Title, and not to any post-entry content. Accordingly, if you use an H1 heading in the post-entry content, you'll find that it is styled rather similarly to the H2 heading tag.
2. The Theme template files ensure that the most important content - the post-entry content - is rendered as early as possible. The loop.php template file is called first, and the sidebar-left.php and sidebar-right.php files are called second. 
3. The Theme supplies a default breadcrumb navigation function.
4. The Theme includes plug-and-play support for the following plugins: WP-Paginate, Yoast Breadcrumbs

Most of the rest is really up to the user. The Theme is intended to be SEO-neutral: neither hurting your SEO, nor going out of its way (and adding considerable bloat that is better added via the many good plugins available) to improve it.

= Where did my social icons go? =

In version 3.3, the social profile link icon handling was changed from using Theme options to using a custom navigation menu for storing social profile links. This 
change will keep your social profile links portable from Theme to Theme, and provides built-in support for other Themes that use this method. To add your social icons:

* Create a new custom navigation menu, and name it, e.g. "Social". (The name isn't important, as long as you remember it!)
* Add <strong>custom links</strong> to your "Social" menu, under the "Links" metabox, one for each social network profile you wish to include.
* Save the menu, and assign it to the "Social Profile Links" Theme Location.
* Now your social profile link icons will appear as they did before.

== Screenshots ==

1. Standard Theme Screenshot

== License ==

= Oenology WordPress Theme, Copyright (C) 2010 Chip Bennett =

License: GNU General Public License, v2 (or newer)
License URI:

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

= Bundled Scripts =

**Cycle2, Copyright 2012 M. Alsup**

License: MIT and GPLv2
License URI: /js/cycle2/

**Respond.js, Copyright 2011 Scott Jehl,**

License: Dual-licensed under MIT and GPLv2
License URI: /js/response.js/

**FitVids.js, Copyright 2011, Chris Coyier - + Dave Rupert -**

License: WTFPL
License URI: /js/fitvids.js/jquery.fitvids.js

**TinyNav, Copyright (c) 2011-2012 Viljami Salminen,**

License: MIT
License URI: /js/tinynav.js/

= Bundled Fonts =

**TexGyre Schola Font, Copyright 2005, 2006 C. R. Holder**

License: GUST Font License (GFL) (GPL-compatible)
License URI: /fonts/GUST-FONT-LICENSE.txt

**Genericons, Copyright 2013 Automattic**

License: GNU GPL, Version 2 (or later)
License URI: /fonts/Genericons-LICENSE.txt

= Bundled Images =

**Kirki Customizer Framework, Copyright @aristath**

License: GNU GPL Version 2 (or later)

Image files in /images/layouts

**No Copyright**

pxwhite.jpg is a single-pixel image, and not copyrightable

== Changelog ==

Note: see the "Oenology Reference" admin page for full Changelog details. 
See Dashboard -> Appearance -> Oenology Reference -> Changelog.

= 3.2 [2013.04.09] =
* Maintenance Release

= 3.1 [2013.03.02] =
* Maintenance Release

= 3.0 [2012.12.22] =
* Maintenance Release

= 2.6 [2012.06.14] =
* Maintenance Release

= 2.5 [2011.12.16] =
* Maintenance Release

= 2.4 [2011.10.06] =
* Maintenance Release

= 2.3 [2011.08.12] =
* Maintenance Release

= 2.2 [2011.07.25] =
* Maintenance Release

= 2.1 [2011.06.21] =
* Maintenance Release

= 2.0.3 [2011.06.11] =
* Minor Bugfix Release

= 2.0.2 [2011.06.10] =
* Minor Bugfix Release

= 2.0.1 [2011.06.09] =
* Minor Bugfix Release

= 2.0 [2011.06.09] =
* Major Update Release

= 1.2.2 [2011.05.16] =
* Minor Bugfix Release

= 1.2.1 [2011.04.25] =
* Minor Bugfix Release

= 1.2 [2011.04.25] =
* Update Release

= 1.1 [2011.02.23] =
* Update Release

= 1.0 [2010.12.08] =
* Maintenance Release

= 0.9.2 [2010.11.04] =
* Minor BugFix release

= 0.9.1 [2010.09.24] =
* Initial Release
Something went wrong with that request. Please try again.