“Activism WordPress Theme” Documentation by “Rayoflightthemes.com”

“Activism - Political Activism WordPress Theme”

---

Steps for Theme set-up - top

• 1. Upload „activism.zip“ and „activism-child.zip“ files to WordPress dashboard.

• 2. In WordPress dashboard go to appearance/themes/ and activate theme „Activism“

  

• 3. Install and activate all recommended and required theme’s plugins

  

• 4. Go to tools/import and import demo.xml file

  

• 5. Go to appearance/customize and set home page (front page) for static page

  

• 6. Go to appearance/menus and check if "menu singlepage" and "menu multipage" appears. If you didn't import xml file, please create two menus and name them as you wish. Important is that one menu is for single page website with vertical scroll and another one is default one for multiple pages website. If you imported demo.xml then you already have all set up.

  Read more about menus in next step below and in "Menus" section in documentation.

• 7. Go to appearance/menus and connect menus on menu places. "Menu multipage" to "Default menu for multipage website" and "menu singlepage" to "Menu for single page vertical scroll website". These menus can be changed on pages with page templates.

  

• 8. Go to appearance/customize and add your copyright details, upload logo and add site title and tagline.

  (this is code snippet for copyright with clickable link:

    Copyright <a href="link to your page">copyright text </a>  
    

  )

• If you set home page as static page with template "Front page template with slider" and stil didn't upload revolution slider demo content (revslider_slider_for_import/revslider1.zip) it is perfectly fine if you see this on homepage:

  

  9. Now click to "Revolution slider" in Dashboard and upload revslider_slider_for_import/revslider1.zip file contains demo content and add your images in it. Official plugin page: http://codecanyon.net/item/slider-revolution-responsive-wordpress-plugin/2751380

  

• 10. If you want to make customization in code it is recommended to use Child Theme. Activate activism-child theme and repeat the same for menu and static page settings as for main theme (previous steps).

• 11. Set Event calendar plugin. It is important not to change default settings. Change „events template“ to "Default page template" and save changes. Official page: https://wordpress.org/plugins/the-events-calendar/

Gutenberg update -tips - top

Theme version 1.2.8 and rt-activismtheme-functions plugin version 2.4 brings improved Gutenberg comparibility. If you already purchased theme before it is strongly recommended, before you update it, to import new demo version and start to use Gutenberg instead of old page builder. For new customers - it is recommended to use only Gutenberg editor, not old page builder. New demo file that you can upload, contains content ONLY for Gutenberg editor.

All custom post types (gallery, team etc) now have custom Gutenberg blocks that you can add in Gutenberg editor.

How to set permalinks - top

If you want to use permalinks it is very important to follow next procedure to get it work on all posts, pages and custom post types

1. Deactivate "Activism" theme and all plugins

2. Go to settings/permalinks, set permalinks to default and save

3. Set permalinks to "post name" and save again

4. Activate "Activism" or "Activism child theme"

5. Activate "Events calendar" plugin first

6. Activate all other plugins recommended and required by theme

7. Permalinks should work now

8. If you ever deactivate Events plugin or Theme you need to repeat these steps again to make permalinks work again

How to change color - top

Open "Global colors" settings in appearance/customizer, be sure to choose "Choose this to activate the function" option and then change global theme colors. Colors are unlimited. It is recommended that the color that is added instead of default one has similar lightness and saturation to default color to better fit design.

Shortcodes - top

Note: shortcodes are not needed for new Gutenberg theme version.

[events_timeline limit="5" order="asc" readmore="read more"] For events timeline custom post type. Attributes: limit (-1 for unlimited and any other positive number), order (asc-from oldest to newest, desc-from newest to oldest) readmore (any text you want to appear instead "read more" button text)

[activismtheme_testimonials] For testimonials custom post type

[team limit="4" order="DESC" columnsteam="col-lg-3"] For team custom post type. Add columnsteam="col-lg-3" attribute for 4 columns and columnsteam="col-lg-4" for 3 columns

[homeblog limit="4" order="DESC"] Use this shortcode in page section to display blog posts as columns carousel in homepage. For homeblog you can use category attribute like this: [homeblog category="CATEGORY-ID-YOU-WANT-TO-SHOW"]

[rt_events limit="4" order="DESC"] Use this shortcode to display events from events plugin.

[button_color url="" content="" target=""] [button_dark url="" content="" target=""] [button_color_donation url="" content="" target=""] Shortcodes for buttons [button_color_arrow icon="fa-arrow-right" url="" content="" target=""] Use icon names from this list http://fontawesome.io/cheatsheet/

Bootstrap columns shortcodes

[container]content[/container] [container][one]content[/one][/container] [container][one_third]content[/one_third][one_third]content[/one_third][one_third]content[/one_third][/container] [container][one_forth]content[/one_forth][one_forth]content[/one_forth][one_forth]content[/one_forth][/container] [container][one_half]content[/one_half][one_half]content[/one_half][one_half]content[/one_half][/container]

Menus - top

Explained in first section (Steps for Activism Theme set-up).

Most of the time you will probably only need multipage default menu. In case you need one page website, use single page menu. Very important detail about single page menu is that links in it need to be connected with Gutenberg section "slug" that menu link will scroll to. Sections "slug" and menu link should have the same name.

Be sure to always use "Links" from left side when adding links in "menu single". See screenshot:

Page templates - top

In „page templates“ folder there are page templates with different features. Page template that will show page title or not and templates that show multipage or singlepage menu.

Theme translation - top

Activate translation plugin (can use Polylang, tested with theme). Check if settings/languages tab in Dashboard appears. In Theme's folder "languages" default po and mo files are included. To translate text strings in theme, please rename default.po and default.mo files to "language code" for language you want to translate in, for example if you translate to Portugales language code is "pt_BR" so default.po and default.mo should be renamed to "pt_BR.po" and "pt_BR.mo" Then open po file with Poedit and translate text strings that will appear .http://poedit.net/ More details about WordPress translation here:http://codex.wordpress.org/WordPress_in_Your_Language http://codex.wordpress.org/Installing_WordPress_in_Your_Language

Contact form - top

Make sure contact form plugin is activated and add this code snippet in contact form:

<div class="col-sm-6">
[text* your-name placeholder "Your Name"] 
[email* your-email placeholder "Your Email Address"]
[text* your-subject placeholder "Subject"] 
</div>
<div class="col-sm-6">
[textarea your-message placeholder "Please leave us a message."]
[submit "Send"]
</div>
	
	

How to reorder posts - top

Use this plugin for reordering posts. Instal and activate. It will add re-order link next to every post type for manual post reorder. https://wordpress.org/plugins/post-types-order/

Plugins - top

More about plugins you can find in plugin pages informations.

2 plugins are bundled with theme: 1. Rt activismtheme functions, 2. Revolution slider and other plugins are recommended by theme.

Revolution slider - premium plugin, when this plugin is installed then you can upload revslider1.zip file that contains demo content for this slider. (this is described in Steps for Theme set-up) revslider1.zip is inside "revslider_slider_for_import" folder. Take a look at official documentation in folder "documentation/slider documentation". Official page:

http://codecanyon.net/item/slider-revolution-responsive-wordpress-plugin/2751380

Rt activismtheme functions Theme's plugin that contains custom post types and shortcodes for theme.

Events plugin Timeline events list on front page displays this plugin's posts. It is added via shortcode for events, more information about shortcodes above. Official page: https://wordpress.org/plugins/the-events-calendar/

Contact form 7 plugin For contact form, see information about contact form above. Official page: https://wordpress.org/plugins/contact-form-7/

Font Awesome plugin Official page: https://wordpress.org/plugins/font-awesome-more-icons/

WP Easy Paypal Payment Accept Official page: https://wordpress.org/plugins/wordpress-easy-paypal-payment-or-donation-accept-plugin/

Meta box plugin Official page: https://wordpress.org/plugins/meta-box/

Spectra plugin Official page: https://wordpress.org/plugins/ultimate-addons-for-gutenberg/

WooComemrce plugin Official page: https://wordpress.org/plugins/woocommerce/

TGM plugin activation https://github.com/thomasgriffin/TGM-Plugin-Activation

Widgets - top

Appearance/widgets in Dashboard. Official documentation: http://codex.wordpress.org/WordPress_Widgets

Theme has 7 widgetized areas.

For "footer first" and "header second" widget areas there are code snippets that are used for icons.

In "footer first" widget area add "text widget" and add this code snippet (below) for icons in it and edit it with your links and text. (icon list: http://fontawesome.io/cheatsheet/ ) (If you know nothing about HTML and really really don't know where to add links or change icons, please send support message for help.)

<ul class="socialicons col-lg-12">
<li>
<a href="LINK TO YOUR FB PAGE"><i class="fa fa-facebook">­</i></a>
</li>
<li>
<a href="LINK TO YOUR PAGE"><i class="fa fa-twitter">­</i></a>
</li>
<li>
<a href="LINK TO YOUR PAGE"><i class="fa fa-linkedin">­</i></a>
</li>
<li>
<a href="LINK TO YOUR PAGE"><i class="fa fa-dribbble">­</i></a>
</li>
<li>
<a href="LINK TO YOUR PAGE"><i class="fa fa-youtube">­</i></a>
</li>
<li>
<a href="LINK TO YOUR PAGE"><i class="fa fa-skype">­</i></a>
</li>
<li>
<a href="LINK TO YOUR PAGE"><i class="fa fa-tumblr">­</i></a>
</li>
</ul>

This is code snippet for "header second", procedure the same as for previous widget.

<ul class="socialicons text-right col-lg-12">
<li>
<a href="LINK TO YOUR FB PAGE"><i class="fa fa-facebook">­</i></a>
</li>
<li>
<a href="LINK TO YOUR PAGE"><i class="fa fa-twitter">­</i></a>
</li>
<li>
<a href="LINK TO YOUR PAGE"><i class="fa fa-linkedin">­</i></a>
</li>
<li>
<a href="LINK TO YOUR PAGE"><i class="fa fa-dribbble">­</i></a>
</li>
<li>
<a href="LINK TO YOUR PAGE"><i class="fa fa-youtube">­</i></a>
</li>
<li>
<a href="LINK TO YOUR PAGE"><i class="fa fa-skype">­</i></a>
</li>
<li>
<a href="LINK TO YOUR PAGE"><i class="fa fa-tumblr">­</i></a>
</li>
</ul>

Custom post types - team, testimonials - top

Custom post types in this Theme are: "Team" and "Testimonials". "Events" custom post type is added via plugin (see more above about plugins and shortcodes). Links for custom post types are in top left of Dahsboard.

Team

"Team" custom post type can be added in Theme via shortcode, more information about shortcodes above.

In every "Team" individual post, following information can be added: Headline - for team member name, text editor - for text about team member, feature image - for image, excerpt - for info like social icons that appear on roll over team member image (see Theme demo)

In individual team posts all fields listed above will appear except the excerpt. In Team query, that is added in front page via shortcode, everything listed appears except text added in text editor. It appears only in individual team post.

This is code snippet for adding in excerpt that will appear on roll over team member image. (If you know nothing about HTML and really really don't know where to add links or change icons, please send support message for help.)

	 
	 Team member two
<div class="socialiconsteam">
<ul>
<li><a title="Facebook" href="link.com">[icon name="facebook"]</a></li>
<li><a title="Twitter" href="https://twitter.com">[icon name="twitter"]</a></li>

<li><a title="LinkedIn" href="https://linkedin.com">[icon name="pinterest"]</a></li>
<li><a title="Google Plus" href="https://google.com">[icon name="google-plus"]</a></li>
<li><a title="Tumblr" href="https://tumblr.com">[icon name="tumblr"]</a></li>
</ul>
</div>
	 		
		 

Testimonials

Add posts in testimonials custom post type. One post is for one testimonial that will appear in slider as one slide (see Theme demo) In headline add name and in text editor add text for testimonial.

"Testimonials" custom post type can be added in Theme via shortcode [activismtheme_testimonials] (in Theme demo it is added in one of Parallax section posts), more information about shortcodes above.

Individual testimonial posts should not be visible. Testimonial query added via shortcode in theme (in parallax section) will display information from headline and text editor.

How to change favicon - top

Replace existing one with yours that you can generate at: http://www.favicon-generator.org/

CSS files - top

style.css file as main styling file. In assets/css there are: bootstrap.css, font-awesome.css (with fonts folder), owlcarousel.css, owltheme.css

JS files - top

In assets/js there are all JS files needed, connected via functions.php and scripts.js for preload scripts.

PHP files - top

In assets/php there are queries for testimonials, team, and homeblog that are added in theme via shortcodes and metaboxes. Other php files are standard WP files.

Sources and Credits - top

More about js and css files credit you can find in js and css file’s headers

• TGM plugin activation https://github.com/thomasgriffin/TGM-Plugin-Activation
• Meta boxes https://wordpress.org/plugins/meta-box/
• jQuery Scripts and css files: bootstrap,css, fontawesome.css bootstrap.js, sticky.js, colorbox.js, owltheme.js, bxslider.js, colorbox.js, retina.js, masonry.js
• iconfinder.com, http://flaticon.com/
• Font Awesome font icons
• Google font: Open sans
• Premium plugin: Slider Revolution
• Free plugins customized for Theme and listed above
• Blueprind framework for documentation
• Images for Theme demo: Photodune, Dreamstime, Flickr, Unsplash

---

Once again, thank you so much for purchasing this theme. If you have more general question relating to themes on ThemeForest, you might consider visiting the forums and asking your question in the "Item Discussion" section.

Rayoflightthemes

Go To Table of Contents

---