=== Benevolent ===
Author: Rara Theme (http://raratheme.com)

Tags: Blog, two-columns, right-sidebar, footer-widgets, education, custom-background, custom-menu, featured-image-header, featured-images, post-formats, threaded-comments, translation-ready, full-width-template, theme-options

Requires at least: 4.4.2
Tested up to: 4.5.2
Stable tag: 1.0.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html


== Description ==

Benevolent is a simple, modern and easy to use WordPress theme for non-profit organisations, charity causes, political organisations and foundations. The theme is apt for organisations looking for clean and professional WordPress Theme. The design is responsive and the theme looks great on tablets, laptops and mobile phones. Benevolent comes with several features and it is customisable. The front page has advance slider option, call for donation at several places, project showcase, impact showcase with statistics counter, latest articles and sponsors showcase of the cause. The theme is also SEO friendly which makes it easy to find on search engines like Google. The theme supports all kinds of post formats such as gallery, image, video, etc. It has 4 custom widgets - recent posts, popular posts, social media and about us. The theme is translation ready.   


== Installation ==
        
1. In your admin panel, go to Appearance > Themes and click the Add New button.
2. Click Upload and Choose File, then select the theme's .zip file. Click Install Now.
3. Click Activate to use your new theme right away.

== Documentations ==
1. Setting up the Homepage
    * To set up the homepage you must first create a new page. 
    * Create a new Page
    * Go to Pages > Add New.
    * Enter the Page Title for the Page
    * You do not require to enter anything in the content section for creating a home page. 
    * Select the Homepage Template from the Page Attributes section 
    * Click Publish.

2. Intro Section
    * Go to Appearance>Customizer>Home Page Settings>Intro Section
    * Check Enable Intro Section
    * Enter  Intro Section Title, Intro SectionContent,Intro Titles, Intro Link Labels, Intro URLs and their respective Logos and Images. 
    * Click Save & Publish.

3. Community Section
    * Go to Appearance>Customizer>Home Page Settings>Community Section
    * Check Enable Community Section.
    * EnterCommunity Section Title 
    * Select Post One, Post Two,  Post Three and Post Four.  The Feature Image of the selected posts will be displayed under the section on the Homepage.
    * Click Save & Publish.

4. Stats Counter Section
    * Go to Appearance>Customizer>Home Page Settings>Stats Counter Section
    * Check Enable Stats Counter Section.
    * Enter Stats Counter Numbers and Stats Counter Titles
    * Click Save & Publish.

5. Blog Section:
    * Go to Appearance>Customizer>Home Page Settings>Blog Section
    * Check Enable Blog Section.
    * Check Show Blog Date to display the published date 
    * Enter Blog Section Title, Blog Section Contentand Blog Section read more Text
    * Click Save & Publish.

6. Sponser Section
    * Go to Appearance>Customizer>Home Page Settings>Sponser Section
    * Check Enable Sponser Section.
    * Upload Logo and enter Logo URL
    * Click Save & Publish.

7. Promotional Section
    * Go to Appearance>Customizer>Home Page Settings>Promotional Section
    * Check Enable Promotional Section
    * Enter Promotional Section Title, Button text and Button URL.
    * Upload Background Image.
    * Click Save & Publish.

8. Donate Button
    * Go to Appearance>Customize>Donate Button.
    * Enter Button Text and Button URL
    * Enter Save & Publish.

9. Slider Settings
    * Go to Appearance >Customize>Slider Settings.
    * Check Enable Home Page Slider to show the featured slider the homepage
    * Select the category of posts which you want to display in the slider. (Featured images of the posts of the selected category will be displayed as slider images. )
    * Featured images of posts should be at least 1920 px in width and 970px in the height for displaying slider images properly.
    * Use regenerate thumbnail plugin to crop all the images if you have already uploaded the Images.
    * Click Save & Publish

10. Configuring Slider 
    * Check Enable Slider to Auto Transition for the slides to transition automatically (auto-scroll) without a click. 
    * Check Enable Slider Loop to continue the slide transition in the loop
    * Check Enable Slider Control to allowmanual navigation for paging control of each slide?
    * Check Enable Slider Caption to show the post title to appear on the slider post image
    * Check Enable Slider Thumbnailto show the tiny thumbnail feature images of the slider Posts to appear at the bottom
    * Select the slider animation type to "fade" or "slide"
    * Enter the Readmore text to set the text of the button  
    * Enter Slider Speed: Set the Interval (in milliseconds) at which the slider should change posts(if automatic transition is enabled). Default: 7000 (7 seconds) 
    * Enter Animation  Speed: Set the speed of animations, in milliseconds. Default: 600  
    * Click Save.
    
11. Breadcrumb Settings
    * Go to Appearance>Customizer>Breadcrumb Settings
    * Check Enable Breadcrumb
    * Check Show Current, if you wish to display the current Page on the breadcrumb.
    * Enter Breadcrumb Home Text
    * Enter Breadcrumb Separator
    * Click Save & Publish.

12. Custom CSS Settings
    * Go to Appearance >Customize>Custom CSS settings.
    * Enter the required custom CSS. For example, to change the body font size to 17 Pixels:body{font-size: 17px}
    * Click Save & Publish.


== Copyrights and License ==

Unless otherwise specified, all the theme files, scripts and images are licensed under GPLv2 or later


External resources linked to the theme.
* Raleway Font by through Google Font 
https://www.google.com/fonts/specimen/Raleway
*Font Awesome
https://fortawesome.github.io/Font-Awesome/

# Images
All images are under Creative Commons Public Domain deed CC0.

https://pixabay.com/en/boys-poor-person-children-happy-60680/

Other images are self taken or self created and are GPL compatible.

# JS
All the JS are licensed under GPLv2 or later
https://jqueryui.com/tabs/
http://flexslider.woothemes.com/
https://www.berriart.com/sidr/
https://github.com/bfintal/Counter-Up/blob/master/LICENSE
https://github.com/imakewebthings/waypoints/blob/master/licenses.txt

* Based on Underscores http://underscores.me/, (C) 2012-2015 Automattic, Inc., [GPLv2 or later](https://www.gnu.org/licenses/gpl-2.0.html)


* normalize.css http://necolas.github.io/normalize.css/, (C) 2012-2015 Nicolas Gallagher and Jonathan Neal, [MIT](http://opensource.org/licenses/MIT)


All other resources and theme elements are licensed under the GPLv2 or later


Benevolent WordPress Theme, Copyright Rara Theme 2015, Raratheme.com
Benevolent WordPress Theme is distributed under the terms of the GPLv2 or later


*  This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.
   
   
== Changelog ==
    1.0.2
    * Made string translatable in placeholder of comments.php
    * Data escaped in all widgets.
    * Change the content width to support content in full width.
    
    1.0.1
    * Added Popular Post and Social Links Widgets.
    * Added ability to add Custom CSS in theme options.
    * Added compatibility for custom logo feature.
    * Added comment_template in page.php
    * Updated and integrated new theme tags in style.css