Permalink
Browse files

Settings API rewritten and major documentation overhaul

  • Loading branch information...
1 parent e7e850c commit c21c3244d670540aa4f007289557fe110d8f25c5 @chipbennett committed Jun 6, 2011
Showing with 6,217 additions and 4,586 deletions.
  1. +93 −213 404.php
  2. +61 −57 comments.php
  3. +86 −78 footer.php
  4. +110 −0 front-page.php
  5. +96 −52 functions.php
  6. +238 −1,361 functions/custom.php
  7. +760 −0 functions/hooks.php
  8. +15 −1 functions/options-help.php
  9. +0 −125 functions/options-register-general.php
  10. +0 −73 functions/options-register-varietals.php
  11. +283 −81 functions/options-register.php
  12. +462 −140 functions/options.php
  13. +48 −6 functions/reference-content.php
  14. +14 −0 functions/reference-help.php
  15. +33 −21 functions/reference.php
  16. +467 −1 functions/theme-setup.php
  17. +526 −1 functions/widgets.php
  18. +153 −0 functions/wordpress-hooks.php
  19. +278 −84 header.php
  20. BIN images/cat-rss.png
  21. BIN images/g_marker.gif
  22. BIN images/menu.gif
  23. +0 −18 images/rss.svg
  24. BIN images/subscribewide.jpg
  25. BIN images/subscribewide.png
  26. +108 −197 index.php
  27. +64 −5 infobar.php
  28. +43 −74 loop-footer.php
  29. +31 −4 loop-header.php
  30. +278 −149 loop.php
  31. +99 −179 page.php
  32. +59 −42 post-aside.php
  33. +76 −68 post-audio.php
  34. +81 −47 post-chat.php
  35. +16 −1 post-entry-image.php
  36. +106 −198 post-entry.php
  37. +55 −143 post-footer.php
  38. +78 −53 post-gallery.php
  39. +74 −310 post-header.php
  40. +83 −71 post-image.php
  41. +59 −42 post-link.php
  42. +59 −42 post-quote.php
  43. +59 −42 post-status.php
  44. +76 −68 post-video.php
  45. +94 −49 post.php
  46. +9 −3 readme.txt
  47. +0 −31 sidebar-column-bottom.php
  48. +0 −51 sidebar-column-top.php
  49. +40 −133 sidebar-left.php
  50. +121 −0 sidebar-navigation.php
  51. +101 −0 sidebar-page.php
  52. +36 −58 sidebar-right.php
  53. +237 −0 sidebar.php
  54. +86 −67 site-header.php
  55. +205 −103 site-navigation.php
  56. +36 −19 style.css
  57. +5 −5 varietals/cuvee.css
  58. +5 −5 varietals/malbec.css
  59. +5 −5 varietals/muscat.css
  60. +5 −5 varietals/seyval-blanc.css
  61. +5 −5 varietals/syrah.css
View
306 404.php
@@ -1,225 +1,105 @@
<?php
-/*
-Template Name: 404 Page
-*/
-get_header(); // MUST come first. Calls the header PHP file. Used in all primary template page types (index.php, single.php, archive.php, search.php, page.php) ?>
-
-<body id="home" <?php body_class(); ?>>
-
-<!-- Begin Extent (div#extent) -->
-<div id="extent">
-<?php
- /*
- All displayed content (including the footer) is contained within div#extent, for which width and position are set via CSS.
- */
+/**
+ * Error 404 Page template file
+ *
+ * This file is the Error 404 Page template file, which is output whenever
+ * the server encounters a "404 - file not found" error.
+ *
+ * @link http://codex.wordpress.org/Function_Reference/get_header get_header()
+ * @link http://codex.wordpress.org/Function_Reference/get_footer get_footer()
+ * @link http://codex.wordpress.org/Function_Reference/get_sidebar get_sidebar()
+ *
+ * @package Oenology
+ * @copyright Copyright (c) 2010, Chip Bennett
+ * @license http://www.gnu.org/licenses/old-licenses/gpl-2.0.html GNU General Public License, v2 (or newer)
+ *
+ * @since Oenology 1.0
+ */
?>
- <!-- Begin Header (div#header)-->
- <div id="header">
- <!-- Begin Blog Head -->
- <?php get_template_part('site-header'); // site-header.php contains the Main Navigation Menu, Blog Title and Blog description. ?>
- <!-- End Blog Head -->
-
- </div>
- <!-- End Header (div#header) -->
-
- <?php get_template_part('infobar'); // infobar.php contains the location/breadcrumb/login/search bar. ?>
-
- <!-- Begin Content (div#content) -->
- <div id="content">
- <?php
- /*
- Main blog content (left column, center column, right column) is contained within div#content.
- */
- ?>
+<?php
+/**
+ * Include the header template part file
+ *
+ * MUST come first.
+ * Calls the header PHP file.
+ * Used in all primary template pages
+ *
+ * Codex reference: {@link: http://codex.wordpress.org/Function_Reference/get_header get_header}
+ *
+ * Child Themes can replace this template part file globally, via "header.php",
+ * or in a specific context only, via "header-404.php"
+ */
+get_header( '404' );
+?>
- <!-- Begin Main (div#main) -->
- <div id="main">
+<!-- Begin Main (div#main) -->
+<?php
+/**
+ * div#main contains the center column content of the three-column
+ * layout, and the left-column content of the two-column layout.
+ * Generally, this column contains the main content of the page
+ * (blog post/posts, page content, search results, etc.), and
+ * contains the WordPress "Loop". For other non-WordPress pages
+ * (or any page not containing the "Loop") the site structure
+ * can be kept consistent by replacing "loop.php" with whatever
+ * file (or static content) is desired.
+ */
+?>
+<div id="main">
- <div <?php post_class(); ?>>
-
- <div class="post-title">
- <h1>Don't Panic</h1>
- </div>
-
- <div class="post-entry">
- <p>Oh no, not again.</p>
- <p>Well, this is weird. The post, page, or file you requested could not be found. The best laid plans of mice, and all that. Those who study the complex interplay of cause and effect in the history of the Universe say that this sort of thing is going on all the time. </p>
- <p>I apologize for the inconvenience.</p>
- <?php
- if ( function_exists( 'oenology_404_handler') ) {
- oenology_404_handler();
- }
- ?>
- </div>
-
- </div>
+ <div <?php
+ post_class();
+ ?>>
+ <div class="post-title">
+ <h1>Don't Panic</h1>
</div>
- <!-- End Main (div#main) -->
-
- <!-- Begin Left Column (div#leftcol) -->
- <div id="leftcol">
- <?php
- /*
- div#leftcol contains the left column content of the three-column layout.
- */
- get_sidebar('left');
- /*
- sidebar-left.php is the left column content. Used in all primary template page types (index.php, single.php, archive.php, search.php, page.php)
- For index.php, sidebar-left and sidebar-right both appear to the right of the main content column.
- For page.php, sidebar-left is to the left, and sidebar-right is to the right, with the main content column in the center.
- */
- ?>
- </div>
- <!-- End Left Column (div#leftcol) -->
-
- <!-- Begin Right Column (div#rightcol) -->
- <div id="rightcol">
- <?php
- /*
- div#rightcol contains the right column content of the three-column layout.
- */
- get_sidebar('right');
- /*
- sidebar-right.php is the right column content. Used in all primary template page types (index.php, single.php, archive.php, search.php, page.php)
- For index.php, sidebar-left and sidebar-right both appear to the right of the main content column.
- For page.php, sidebar-left is to the left, and sidebar-right is to the right, with the main content column in the center.
- */
- ?>
+
+ <div class="post-entry">
+ <?php
+ /**
+ * Fire the 'oenology_hook_post_404' hook
+ *
+ * @return mixed any content hooked into 'oenology_hook_post_404'
+ */
+ oenology_hook_post_404();
+ ?>
</div>
- <!-- End Right Column (div#rightcol) -->
</div>
- <!-- End Content (div#content)-->
+
+</div>
+<!-- End Main (div#main) -->
- <div id="container" style="clear:both;">&nbsp;</div>
-
- <?php get_footer(); // Used in all primary template page types (index.php, single.php, archive.php, search.php, page.php) ?>
+<?php
+/**
+ * Include the sidebar template part file
+ *
+ * Calls a sidebar template part file.
+ * Used in all primary template pages, except static Pages.
+ *
+ * Codex reference: http: *codex.wordpress.org/Function_Reference/get_sidebar
+ *
+ * Child Themes can replace this template part file globally,
+ * via "sidebar.php", or in the Error 404 Page context only, via
+ * "sidebar-404.php"
+ */
+get_sidebar( oenology_get_context() );
+?>
-<?php /*
-Reference:
-=============================================================================
-The following functions, tags, and hooks are used (or referenced) in this Theme template file:
-
-***********************
-body_class()
-----------------------------------
-body_class() is a WordPress template tag.
-Codex reference: http://codex.wordpress.org/Template_Tags/body_class
-
-body_class() is added inside the HTML <body> tag, and outputs various CSS class
-declarations, depending on which page is currently being displayed.
-
-For the full list of CSS classes returned by body_class(), see the Codex.
-
-***********************
-function_exists()
-----------------------------------
-function_exists() is a boolean (returns TRUE or FALSE) conditional PHP function.
-Codex reference: N/A
-PHP reference: http://php.net/manual/en/function.function-exists.php
-
-function_exists( 'foo' ) returns TRUE if a function named foo() is found; otherwise, it returns FALSE.
-
-***********************
-get_footer()
-----------------------------------
-get_footer() is a WordPress template tag.
-Codex reference: http://codex.wordpress.org/Function_Reference/get_footer
-
-get_footer() is used to include the footer Theme template file (footer.php) within another. This function facilitates
-re-use of Theme template files, and also facilitates child Theme template files to take precedence
-over parent Theme template files.
-
-get_footer( $foo ) will attempt to include footer-foo.php. If it doesn't exist, the default footer.php will be used.
-
-***********************
-get_header()
-----------------------------------
-get_header() is a WordPress template tag.
-Codex reference: http://codex.wordpress.org/Function_Reference/get_header
-
-get_template_part() is used to include the header Theme template file (header.php) within another. This function facilitates
-re-use of Theme template files, and also facilitates child Theme template files to take precedence
-over parent Theme template files.
-
-get_header( $foo ) will attempt to include header-foo.php. If it doesn't exist, the default header.php will be used.
-
-***********************
-get_sidebar()
-----------------------------------
-get_sidebar() is a WordPress template tag.
-Codex reference: http://codex.wordpress.org/Function_Reference/get_sidebar
-
-get_sidebar() is used to include a sidebar template file within another. This function facilitates
-re-use of Theme template files, and also facilitates child Theme template files to take precedence
-over parent Theme template files.
-
-get_sidebar( $name ) will attempt to include sidebar-name.php. The function will attempt to
-include files in the following order, until it finds one that exists:
- - the Theme's sidebar-name.php
- - the Theme's sidebar.php
- - the parent Theme's sidebar-name.php
- - the parent Theme's sidebar.php
-
-get_sidebar() with no argument passed will attempt to include sidebar.php. The function will
-attempt to include files in the following order, until it finds one that exists:
- - the Theme's sidebar.php
- - the parent Theme's sidebar.php
-
-***********************
-get_template_part()
-----------------------------------
-get_template_part() is a WordPress template tag.
-Codex reference: http://codex.wordpress.org/Function_Reference/get_template_part
-
-get_template_part() is used to include a Theme template file within another. This function facilitates
-re-use of Theme template files, and also facilitates child Theme template files to take precedence
-over parent Theme template files.
-
-get_template_part( $file ) will attempt to include file.php. The function will attempt to
-include files in the following order, until it finds one that exists:
- - the Theme's file.php
- - the parent theme's file.php
-
-get_template_part( $file , $foo ) will attempt to include file-foo.php. The function will
-attempt to include files in the following order, until it finds one that exists:
- - the Theme's file-foo.php
- - the Theme's file.php
- - the parent theme's file-foo.php
- - the parent theme-s file.php
-
-***********************
-oenology_404_handler()
-----------------------------------
-oenology_404_handler() is a custom Theme function.
-Codex reference: N/A
-
-oenology_404_handler() is used to generate suggested site content when a user is sent to
-the 404 page due to a server 404 "file not found" error.
-
-oenology_404_handler() is defined in functions.php.
-
-***********************
-post_class()
-----------------------------------
-post_class() is a WordPress template tag.
-Codex reference: http://codex.wordpress.org/Template_Tags/post_class
-
-post_class() is added inside the HTML <div> or <span> tag that contains the post,
-and outputs various CSS class declarations, depending on which post is currently
-being displayed.
-
-For the full list of CSS classes returned by post_class(), see the Codex.
-
-***********************
-wp_footer()
-----------------------------------
-wp_footer() is a WordPress action hook.
-Codex reference: http://codex.wordpress.org/Plugin_API/Action_Reference/wp_footer
-
-wp_footer() is used by themes/plugins, usually to insert content into the WordPress Theme footer.
-
-=============================================================================
-*/ ?>
+<?php
+/**
+ * Include the footer template part file
+ *
+ * MUST come last.
+ * Calls the footer PHP file.
+ * Used in all primary template pages
+ *
+ * Codex reference: {@link http: *codex.wordpress.org/Function_Reference/get_footer get_footer}
+ *
+ * Child Themes can replace this template part file globally, via "footer.php",
+ * or in a specific context only, via "footer-{context}.php"
+ */
+get_footer( 'front-page' );
+?>
Oops, something went wrong.

0 comments on commit c21c324

Please sign in to comment.