=== amaThambo ===

Contributors: 			sailorgoodway
Requires at least: 		WordPress 5.0
Tested up to: 			WordPress 5.0
Stable tag: 			1.1
Version: 				1.1
Requires PHP:			5.2
License: 				GPLv2 or later
License URI:			http://www.gnu.org/licenses/gpl-2.0.html
Tags: 					grid-layout, custom-background, custom-header, custom-menu, custom-logo, editor-style, featured-images, footer-widgets, sticky-post, theme-options, threaded-comments, translation-ready, blog, photography, portfolio

Great for any blog that uses featured images, albeit a photography or portfolio type site. Can be used for a personal blog as well. The theme plays very nicely with the Gutenberg editor. Ideal for the blogger who does not mind getting hands-on with the code to build a child theme that will be uniquely their own.

amaThambo is a Zulu word meaning 'bones'.

== amaThambo Copyright ==

1. The theme is distributed under the terms of the GNU GPL (GPLv2 or later).

2. The theme is based on Underscores https://underscores.me/, (C) 2012-2017 Automattic, Inc.
Underscores is distributed under the terms of the GNU GPL v2 or later.

3. The theme bundles the following third-party resources:

	3.1. normalize.css, Copyright 2012-2016 Nicolas Gallagher and Jonathan Neal License: MIT Source: https://necolas.github.io/normalize.css/

	3.2. FitVids 1.1, Copyright 2013, Chris Coyier - http://css-tricks.com + Dave Rupert - http://daverupert.com, Released under the WTFPL license - http://sam.zoy.org/wtfpl/

	3.3. In the customizer use is made of a text radio button. The author of this custom control is Anthony Hortin, https://maddisondesigns.com, licensed under the GNU General Public License v2 or later.

	3.4. The social menu in the theme makes use of Genericons which is licensed under the GNU General Public License v2 or later.

	3.5. There are 2 small images included with the theme, one for use with the scroll-to-top functionality, the other a dummy featured image needed by the custom widgets included with the theme. Both these images are my own.

	3.6. There are 3 custom widgets included. These are also my own. The custom widgets as well as the mentioned images are all released under the terms of the GNU GPL (GPLv2 or later).

== Theme Features ==

 1. Accessibility ready.
 2. Fully responsive.
 3. Single column layout.
 4. Three dynamic footer widget areas.
 5. Three menu positions, primary, social and footer.
 6. Custom logo.
 7. Custom background.
 8. Customizer options.
 9. Masonry layout on blog and archive pages.
10. Editor styles for both Gutenberg and classic (MCE) editors.
11. Translation ready.
12. Displays big featured images.
13. Works well on the modern versions of all browsers.
14. Easy to customise via a child theme.

== Setting Up The Theme ==

1. In your admin panel, go to Appearance -> Themes and click the 'Add New' button.
2. Type in amaThambo in the search form and press the 'Enter' key on your keyboard.
3. Click on the 'Activate' button to use your new theme right away.
4. If you are activating the theme on a site with pre-existing images you need to install and run the plugin Regenerate Thumbnails as this theme makes use of custom-sized images.
4. Setup menus.
5. Setup footer widgets.
6. Select required Customizer options.
7. Add privacy page if required in your country.
8. Make any required customisation changes.

== Customization ==
1. Select required options in Customizer.
2. Create child theme.
3. Make required changes to stylesheet.
4. Find code partials in theme and make required changes.
5. Find pluggable functions in theme and make required changes.
6. Change and replace theme template files if required.
7. More details on customisation can be found at https://arnoldgoodway.com

== Frequently Asked Questions ==

= Is support offered for the theme? =
Yes, the normal avenue of support via the WordPress Forums as well as my personal website (https://arnoldgoodway.com/). As queries arise the website will be updated with support articles.

= Are there sidebars that can be used? =
The theme is a single column theme but obviously this can be changed via a child theme. Footer widget areas are provided.

= Can I use the theme without a child theme? =
If you are not planning to make any changes, yes, you could. If you do make changes without a child theme these changes will be lost when I update the theme.

== Theme Limitations ==

1. No custom header - text on image raises accessibility issues.
2. Flat footer menu - will wrap on small screens but if there are too many items it could quickly look very messy on small screens.
3. Custom logo restriced to 100px square.
4. No pages included in search results.
5. No front page template.
6. No styling for post formats.
7. No RTL support. Up to WordPress 5.0 RC2 the Gutenberg RTL stylesheets were still not loading. This is something that will receive attention in a later version of the theme.

== Changelog ==

= 1.0 =
Submitted to WordPress Theme Repository 5 December 2018.

= 1.1 = Theme not reviewed yet.
1. Removed duplicate footer_dynamic_widgets function.
2. Replaced screenshot.png.

= 1.2 = Theme not reviewed yet.
1. Blocked the excerpt length and excerpt more functions from affecting the admin area.
2. Removed search-form from add_theme_support( 'html5' ) in functions.php.