This wiki is for the exclusive use of my friends and colleagues. Account creation and anonymous editing have been turned off.

If you are a friend or colleague of mine, and would like to participate in this project, please send me a message.

If you find these pages useful, please donate to help cover server costs. Thanks!

Difference between revisions of "Atticus Finch Documentation"

From OdleWiki
m (→‎Widget Areas: Initial write)
m (Added going away note)
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
{{Template:AtticusFinch}}
 +
 
This page describes the theme options available for the Atticus Finch WordPress theme, version 0.3.
 
This page describes the theme options available for the Atticus Finch WordPress theme, version 0.3.
  
== Post Format Options ==
+
'''This page is going away in favor of the following two pages:'''
 +
 
 +
* [[Atticus Finch Theme Features]]
 +
* [[Atticus Finch Theme Options]]
 +
 
 +
== Theme Features ==
 +
 
 +
Atticus Finch supports the following [https://codex.wordpress.org/Theme_Features theme features]:
 +
 
 +
* [https://codex.wordpress.org/Automatic_Feed_Links Automatic Feed Links]
 +
* [https://codex.wordpress.org/Title_Tag Title Tag]
 +
* [https://codex.wordpress.org/Post_Thumbnails Post Thumbnails (Featured Images)]
 +
* [https://codex.wordpress.org/Post_Formats Post Formats] (See [[#Post_Format_Options|below]])
 +
* [https://codex.wordpress.org/Custom_Backgrounds Custom Backgrounds]
 +
* [https://codex.wordpress.org/Custom_Headers Custom Header Images]
 +
* [https://codex.wordpress.org/Theme_Markup Theme Markup]
 +
 
 +
== Theme Options ==
 +
 
 +
=== Post Format Options ===
  
 
Atticus Finch supports the use of [https://codex.wordpress.org/Post_Formats post formats]. It currently supports the following post formats:
 
Atticus Finch supports the use of [https://codex.wordpress.org/Post_Formats post formats]. It currently supports the following post formats:
Line 15: Line 36:
 
* Video
 
* Video
  
Additional options are available for the ''aside, link, quote,'' and ''status'' post formats. (See http://techblog.kjodle.net/2015/09/19/make-wordpress-post-formats-all-they-can-be/ for the philosophy behind these options.)
+
The following options are available for the ''aside, link, quote,'' and ''status'' post formats. (See http://techblog.kjodle.net/2015/09/19/make-wordpress-post-formats-all-they-can-be/ for the philosophy behind these options.)
  
=== Post Format Title Options ===
+
==== Post Format Title Options ====
  
 
[[File:af-post-format-title.png|thumb|150px|Atticus Finch Post Format Title Options]]
 
[[File:af-post-format-title.png|thumb|150px|Atticus Finch Post Format Title Options]]
Line 24: Line 45:
  
 
The options are checkboxes, meaning that you can enable the option for one, some, or all post formats.
 
The options are checkboxes, meaning that you can enable the option for one, some, or all post formats.
 +
 +
This option affects these post formats in all locations: home page, archive pages, and individual posts.
  
 
<div style="clear:both;"></div>
 
<div style="clear:both;"></div>
  
=== Post Format Excerpt Options ===
+
==== Post Format Excerpt Options ====
  
 
[[File:af-post-format-excerpt.png|thumb|150px|Atticus Finch Post Format Excerpt Options]]
 
[[File:af-post-format-excerpt.png|thumb|150px|Atticus Finch Post Format Excerpt Options]]
  
You can choose whether to display excerpts for full content for the above post formats on the home page and on archive pages.
+
By default, Atticus Finch displays post excerpts on the home page and in archive pages. However, because asides, links, quotes, and statuses tend to be shorter, you can choose whether to display excerpts for full content for the above post formats on the home page and on archive pages. In this way, if one of these posts is slightly longer than the default excerpt length, it will still display in its entirety.
  
 
The options are checkboxes, meaning that you can enable the option for one, some, or all post formats.
 
The options are checkboxes, meaning that you can enable the option for one, some, or all post formats.
Line 39: Line 62:
 
<div style="clear:both;"></div>
 
<div style="clear:both;"></div>
  
== Widget Areas ==
+
=== Widget Areas Options ===
  
[[File:Af-widget-areas.png|thumb|150px|Partial display of Atticus Finch Widget Areas Options]]
+
Information about widget areas is [[Atticus_Finch_Widget_Areas | here]].
  
Atticus Finch has 21 different widget areas, allowing you to easily add content outside a post or sidebar without editing theme files or creating a child theme. Those areas are:
+
=== Header and Background Images ===
  
* Before Header
+
Atticus Finch supports both custom header and custom background images, although it does not ship with them.
* After Top Menu
 
* Before Social Media
 
* Before Primary Menu
 
* After Header
 
* Top of Container
 
* Before Post Title
 
* Before Post Content
 
* Top of Post
 
* Bottom of Post
 
* After Post Content
 
* Before Post Meta
 
* After Post Meta
 
* Before Comments
 
* After Comments
 
* Before Comment Form
 
* After Comment Form
 
* Bottom of Container
 
* Before Footer Menu
 
* Top of Footer
 
* Bottom of Footer
 
* Before Footer
 
  
'''Note:''' All of these areas are unstyled. You can style them with CSS in a child theme stylesheet.
+
==== Header Images ====
  
To target '''all''' widget areas, use the css class <span class="mono">atticus-finch-action-hook</span>.
+
Currently, Atticus Finch recommends a custom header image of 1000 x 250 pixels. However, because the header of the theme extends the entire width of the screen, it is probably better to not use a header image.
  
To target '''individual''' widget areas, use the following css id's:
+
==== Background Images ====
  
{| class="wikitable sortable"
+
Any size background image may be used. However, Atticus Finch does not currently support full-size background images, so use a tileable image.
|-
 
! Widget Area !! CSS ID
 
|-
 
| Before Header || <span class="mono">atticus_finch_before_header</span>
 
|-
 
| After Top Menu || <span class="mono">atticus_finch_after_top_menu</span>
 
|-
 
| Before Social Media || <span class="mono">atticus_finch_before_social_media</span>
 
|-
 
| Before Primary Menu || <span class="mono">atticus_finch_before_primary_menu</span>
 
|-
 
| After Header || <span class="mono">atticus_finch_after_header</span>
 
|-
 
| Top of Container || <span class="mono">atticus_finch_container_top</span>
 
|-
 
| Before Post Title || <span class="mono">atticus_finch_before_post_title</span>
 
|-
 
| Before Post Content || <span class="mono">atticus_finch_before_post_content</span>
 
|-
 
| Top of Post || <span class="mono">atticus_finch_post_top</span>
 
|-
 
| Bottom of Post || <span class="mono">atticus_finch_post_bottom</span>
 
|-
 
| After Post Content || <span class="mono">atticus_finch_after_post_content</span>
 
|-
 
| Before Post Meta || <span class="mono">atticus_finch_before_post_meta</span>
 
|-
 
| After Post Meta || <span class="mono">atticus_finch_after_post_meta</span>
 
|-
 
| Before Comments || <span class="mono">atticus_finch_before_comments</span>
 
|-
 
| After Comments || <span class="mono">atticus_finch_after_comments</span>
 
|-
 
| Before Comment Form || <span class="mono">atticus_finch_before_comment_form</span>
 
|-
 
| After Comment Form || <span class="mono">atticus_finch_after_comment_form</span>
 
|-
 
| Bottom of Container || <span class="mono">atticus_finch_container_bottom</span>
 
|-
 
| Before Footer Menu || <span class="mono">atticus_finch_before_footer_menu</span>
 
|-
 
| Top of Footer || <span class="mono">atticus_finch_footer_top</span>
 
|-
 
| Bottom of Footer || <span class="mono">atticus_finch_footer_bottom</span>
 
|-
 
| Before Footer || <span class="mono">atticus_finch_after_footer</span>
 
|}
 
  
<div style="clear:both;"></div>
+
=== Print Options ===
  
== Header and Background Images ==
+
[[File:Af-print-options.png|thumb|150px]]
  
Atticus Finch supports both custom header and custom background images, although it does not ship with them.
+
The Atticus Finch Theme is print-friendly. The following items will '''not''' print:
  
=== Header Images ===
+
* site header
 +
* sidebar
 +
* site footer
  
Currently, Atticus Finch recommends a custom header image of 1000 x 250 pixels. However, because the header of the theme extends the entire width of the screen, it is probably better to use a smaller image that tiles. More testing is required.
+
==== URL Information ====
  
=== Background Images ===
+
Ticking the box marked "Print URL information at end of post" will display the URL of the document in a bordered paragraph on the last page of the document. See the sample below.
  
Any size background image may be used. However, Atticus Finch does not currently support full-size background images, so use a tileable image.
+
==== Copyright ====
  
== Print Options ==
+
Ticking the box marked "Print copyright information at end of post" will display the contents of the "Copyright Information" option in a bordered paragraph on the last page of the document. See the sample below.
  
The Atticus Finch Theme is print-friendly.
+
[[File:Af-print-display.png|border]]
  
== Copyright Information ==
+
=== Copyright Information Option ===
  
 
[[File:Af-copyright-001.png|thumb|150px]]
 
[[File:Af-copyright-001.png|thumb|150px]]
Line 151: Line 108:
 
<div style="clear:both;"></div>
 
<div style="clear:both;"></div>
  
== Social Media Options ==
+
=== Social Media Options ===
 +
 
 +
[[File:Af-social-media-options.png|border]]
 +
 
 +
Atticus Finch will display links to your social media profiles as icons in the header area. It currently supports the following social media sites:
 +
 
 +
* Twitter (allows for two Twitter accounts)
 +
* Facebook
 +
* Instagram
 +
* YouTube
 +
* Pinterest
 +
* Amazon Wishlist
  
== Custom CSS ==
+
'''Note:''' At the present moment, you must enter the complete URL for each profile.
  
== Miscellaneous Options ==
+
The icons are light grey, but animate to a larger, colored version of the icon in the hover state:
 +
 
 +
[[File:Af-social-media-icons.png|border]]
 +
 
 +
=== Custom CSS ===
 +
 
 +
Early versions of Atticus Finch included a custom CSS options; however this has been deleted since it is now a part of WordPress core.
 +
 
 +
=== Mobile Options ===
 +
 
 +
=== Mobile Menu Options ===
 +
 
 +
=== Miscellaneous Options ===
  
 
[[File:Af-misc.png|thumb|150px]]
 
[[File:Af-misc.png|thumb|150px]]
Line 161: Line 141:
 
Atticus Finch also has a number of miscellaneous options.
 
Atticus Finch also has a number of miscellaneous options.
  
=== Copyright Information in Footer ===
+
==== Copyright Information in Footer ====
  
 
If you have entered your copyright information in the "Copyright Information" option, tick this box to make it appear on the bottom of each page.
 
If you have entered your copyright information in the "Copyright Information" option, tick this box to make it appear on the bottom of each page.
Line 167: Line 147:
 
This option allows you to toggle showing your copyright information without having to delete it from the "Copyright Information" option.
 
This option allows you to toggle showing your copyright information without having to delete it from the "Copyright Information" option.
  
=== Developer Credits in Footer ===
+
==== Developer Credits in Footer ====
  
 
Unticking this box hides the "Powered by WordPress and the Atticus Finch Theme" message in the footer of each page.
 
Unticking this box hides the "Powered by WordPress and the Atticus Finch Theme" message in the footer of each page.
  
=== "Edit this post" Link for Logged-In Users ===
+
==== "Edit this post" Link for Logged-In Users ====
  
 
Ticking this box displays a link to edit posts on the front end of your blog for logged in users who have the ability to edit posts.
 
Ticking this box displays a link to edit posts on the front end of your blog for logged in users who have the ability to edit posts.
  
=== Excerpt Length ===
+
[[File:Af-edit-post-link.png|border|"Edit this post" link shown in hover state.]]
 +
 
 +
==== Excerpt Length ====
 +
 
 +
Use this option to change the length of excerpts. The default is 20; the maximum accepted value is 100. If you edit a value larger than 100, it will revert to 100 upon saving.
 +
 
 +
== Theme Customization ==
 +
 
 +
Atticus Finch has a lot of options available right out of the box. If you want additional options, or to customize the theme's appearance, you'll need to use a child theme. Fortunately, Atticus Finch has a child theme already available. See [[Atticus Finch Child Theme]] for instructions on how to download and use it.
  
Use this option to change the length of excerpts. The default is 20; the maximum accepted value is 100. If you edit a value larger than 100, it will revert to 100.
+
== Theme Functions ==
  
[[Category:Atticus Finch Theme]]
+
[[Category:WordPress]]

Latest revision as of 20:02, 11 June 2017

Atticus-finch-outline.png

Atticus Finch Theme
A monochrome theme for WordPress


This page describes the theme options available for the Atticus Finch WordPress theme, version 0.3.

This page is going away in favor of the following two pages:

Theme Features

Atticus Finch supports the following theme features:

Theme Options

Post Format Options

Atticus Finch supports the use of post formats. It currently supports the following post formats:

  • Aside
  • Audio
  • Chat
  • Gallery
  • Image
  • Link
  • Quote
  • Status
  • Video

The following options are available for the aside, link, quote, and status post formats. (See http://techblog.kjodle.net/2015/09/19/make-wordpress-post-formats-all-they-can-be/ for the philosophy behind these options.)

Post Format Title Options

Atticus Finch Post Format Title Options

You can choose whether to display titles for the above post formats.

The options are checkboxes, meaning that you can enable the option for one, some, or all post formats.

This option affects these post formats in all locations: home page, archive pages, and individual posts.

Post Format Excerpt Options

Atticus Finch Post Format Excerpt Options

By default, Atticus Finch displays post excerpts on the home page and in archive pages. However, because asides, links, quotes, and statuses tend to be shorter, you can choose whether to display excerpts for full content for the above post formats on the home page and on archive pages. In this way, if one of these posts is slightly longer than the default excerpt length, it will still display in its entirety.

The options are checkboxes, meaning that you can enable the option for one, some, or all post formats.

You can also select the text to use for the "Read More" link. The default is "…read more…". Note: This will affect all post formats, not just the four listed above.

Widget Areas Options

Information about widget areas is here.

Header and Background Images

Atticus Finch supports both custom header and custom background images, although it does not ship with them.

Header Images

Currently, Atticus Finch recommends a custom header image of 1000 x 250 pixels. However, because the header of the theme extends the entire width of the screen, it is probably better to not use a header image.

Background Images

Any size background image may be used. However, Atticus Finch does not currently support full-size background images, so use a tileable image.

Print Options

Af-print-options.png

The Atticus Finch Theme is print-friendly. The following items will not print:

  • site header
  • sidebar
  • site footer

URL Information

Ticking the box marked "Print URL information at end of post" will display the URL of the document in a bordered paragraph on the last page of the document. See the sample below.

Copyright

Ticking the box marked "Print copyright information at end of post" will display the contents of the "Copyright Information" option in a bordered paragraph on the last page of the document. See the sample below.

Af-print-display.png

Copyright Information Option

Af-copyright-001.png

The option "Copyright Information" provides a place to include your copyright information. You can include any combination of text and HTML.

Note: This information will appear in the footer of all pages. However, you must also tick the box labeled "Display copyright information in footer" under "Miscellaneous Options".

Social Media Options

Af-social-media-options.png

Atticus Finch will display links to your social media profiles as icons in the header area. It currently supports the following social media sites:

  • Twitter (allows for two Twitter accounts)
  • Facebook
  • Instagram
  • YouTube
  • Pinterest
  • Amazon Wishlist

Note: At the present moment, you must enter the complete URL for each profile.

The icons are light grey, but animate to a larger, colored version of the icon in the hover state:

Af-social-media-icons.png

Custom CSS

Early versions of Atticus Finch included a custom CSS options; however this has been deleted since it is now a part of WordPress core.

Mobile Options

Mobile Menu Options

Miscellaneous Options

Af-misc.png

Atticus Finch also has a number of miscellaneous options.

Copyright Information in Footer

If you have entered your copyright information in the "Copyright Information" option, tick this box to make it appear on the bottom of each page.

This option allows you to toggle showing your copyright information without having to delete it from the "Copyright Information" option.

Developer Credits in Footer

Unticking this box hides the "Powered by WordPress and the Atticus Finch Theme" message in the footer of each page.

"Edit this post" Link for Logged-In Users

Ticking this box displays a link to edit posts on the front end of your blog for logged in users who have the ability to edit posts.

"Edit this post" link shown in hover state.

Excerpt Length

Use this option to change the length of excerpts. The default is 20; the maximum accepted value is 100. If you edit a value larger than 100, it will revert to 100 upon saving.

Theme Customization

Atticus Finch has a lot of options available right out of the box. If you want additional options, or to customize the theme's appearance, you'll need to use a child theme. Fortunately, Atticus Finch has a child theme already available. See Atticus Finch Child Theme for instructions on how to download and use it.

Theme Functions