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

“Activism - Political Activism WordPress Theme”

Created: 09/22/2014 m/d/y
By: Rayoflightthemes

Thank you for purchasing Activism WordPress Theme. Please read documentation and follow instructions for theme set-up.

If you have questions please send email through Rayoflightthemes Themeforest contact form using account that you purchased theme with to confirm purchase.

Before contact please read more about support on Rayoflightthemes profile page.

Click HERE for Rayoflightthemes Themeforest profile page.

Thanks so much!


Table of Contents

  1. Steps for Theme set-up - READ FIRST!
  2. Gutenberg update - tips
  3. How to set permalinks
  4. How to change color
  5. Shortcodes
  6. Menus
  7. Page templates
  8. Theme translation
  9. Contact form
  10. How to reorder posts
  11. Plugins
  12. Widgets
  13. Custom post types - team, testimonials
  14. How to change favicon
  15. CSS files
  16. JS files
  17. PHP files
  18. Sources and credits

Steps for Theme set-up - top

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


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