CityGov

Theme Documentation

Hello there...

Thank you for purchasing my theme. If you have any questions that are beyond the scope of this help file, please feel free to contact me via Support page. Thanks so much!

Created: 16.11.2018; Updated: 27.7.2022
By: Dannci & Themnific | Support*

* Please note, that theme support does not include:

  • Customization and installation services
  • Support for third party software and plug-ins

 

Theme Instalation

Installation via WP Dashboard:
  1. Unzip/extract the main (downloaded) theme package – to get citygov.zip file,
  2. Go to Appearance >Themes,
  3. click on “Add New” > and “Upload theme”,
  4. click on ‘Browse’ button, find citygov.zip file on your computer and press 'Install Now',
  5. Activate theme,
  6. After theme activation go to Appearance > Install Plugins, and install and activate Redux Framework plugin!
  7. Refresh admin page and 'CityGov - admin panel' button will appear;
  8. Go to CityGov - admin panel (theme options) and setup theme.

 

Installation via FTP:
  1. Unzip/extract the main (downloaded) theme package / twice / to get theme folder ‘citygov’,
  2. Using FTP client (e.g. Filezilla) upload 'citygov' folder into 'themes' folder in your WordPress installation ( YOUR_HOSTING_ROOT/YOUR_SUBDIRECTORY/wp-content/themes/ ),
  3. Go to Appearance >Themes, find CityGov theme and activate theme,
  4. After theme activation go to Appearance > Install Plugins, and install and activate Redux Framework plugin!
  5. Refresh admin page and 'CityGov - admin panel' button will appear;
  6. Go to CityGov - admin panel (theme options) and setup theme.

 

You have to install and activate required plugins (Redux, Elementor and Eleslider). You can do this by visiting Appearance » Install Plugins inside wp dashboard.

Required Plugins

The following message may be visible after theme activation:

img

Go to Appearance » Install Plugins and install and activate following plugins:

  1. Redux Framework
  2. Elementor: after activation go to Elementor > Settings and make basic setup of the plugin:
    Save changes and that's it. You can edit any page in the page builder later.

 

Default Setup

1. After theme activation go to Appearance > Install Plugins, and install and activate Redux Framework plugin!

2. Then go to CityGov - admin panel

img

and hit "Save Changes" button to set default style settings:

img

You can change styling options later.

 

2. Following message may be visible after theme activation:

img

Click on 'Begin activating plugins' link and install and activate 'Redux Framework' (if not installed yet), Elementor and 'Shortcode Ultimate' plugins. Or you can do this by visiting Appearance » Install Plugins

 

4. IMPORTANT! It is possible that after theme activation are images wrongly cropped and look ugly! In this case use following plugin: http://wordpress.org/extend/plugins/regenerate-thumbnails/ to regenerate old thumbnails (from previous theme).
After plugin installation start regeneration in Tools > Regen. Thumbnails. This process can take a while and you cannot close tab/window until regeneration is done.

 

 

 

Homepage Setup

  1. In 'Pages' section create new page > name it 'Home'
  2. Select 'Builder' template for this page and save the page:
    img
  3. Go to Settings > Reading and created 'Home' page set as Static page > Front page,
    img
  4. Empty homepage is created now! In next steps, we'll create homepage content using 'Elementor' page builder.

 

 

Elementor

Important!

I recommend creating few classic blog posts and 'Slider posts' before you start creating templates in Elementor. Set 'featured images' for all your posts.

  1. Go to Pages section and edit 'Home' page, which we have created in previous steps:
    img
  2. Make sure that 'Builder' template is selected for this page (a.), then hit 'Edit with Elementor' button (b.):
    img

Adding Main Slider

  1. Make sure that Eleslider plugin is installed. Create few 'Slider' posts in left dashboard menu. (Slider posts types are similar / work similar to classic posts. Set post title, add slide content and set featured image for every slider post. One 'slider' post represents one slide in the slider. See more )
  2. In 'Elementor edit mode' hit on 'Add new section' button and add select 'one column' setion:
    img
    img
  3. Hover over the section and click on 2nd blue icon to edit section (a.) In left section select 'Full Width' and 'No Gap' options (b.)
    img
  4. Then just click + sign and drag 'Text Editor' block into setion.
    img
  5. Type [eleslider] shortcode into 'Text Editor' block; e.g.
    [eleslider dots_text="no" posts="3" order="ASC"]
    img
    'Slider placeholder' will appear after save. On live homepage will be displayed fully functional slider.

Adding Hero image

 

  1. Add new section and add two column layout:
    img
    img
  2. Hover over the section and click on 2nd blue icon to edit section:
    img
  3. Switch to the Style tab (a.) and add background image (b.)
    img
    img
  4. Then just click on + sign in the left column and drag; e.g. Heading block into it.
    img.
  5. Click on heading; and in Content / Style / Advanced tabs customize the appearance (size, text colors, font style, padding etc.).
    img
    img
  6. After all these, adjust overall padding (spacing) of the 'hero' section.
    a. edit section ,
    b. switch to the Advanced tab,
    c. adjust top and bottom padding of the section.
    img

 

Adding Columns

  1. In 'Elementor edit mode' hit on 'Add new section' button and select e.g. 'two columns' section:
    img
    img
  2. Using Drag&Drop resize columns to e.g. 60% (for wide column) and 40% (for narrow column):
    img
  3. Click on the + sign in wide column and then drag blocks from the left menu; e.g. add 'Themnific: Blog List' block to this wide column:
    img
  4. Adjust 'Number of posts' parameter and optionally select 'featured category' in left panel.
  5. Click on the + sign in narrow column, then drag Heading block from the left menu into it and type the text you want to. Edit styling of this heading (size, color, font, borders etc.).
    img
  6. Edit whole section ( 2nd blue icon) and set background image (choose vertical image). Set the 'Top Left' position and 'Contain' as the size:
    img
    img
  7. edit right column (a.) swith to 'Style' tab (b.) and add background color :
    img

 

  1. Important!
    Adjust padding for responsive mode! When you are building any layout using 'columns' in Elementor; click on small 'Desktop' icon in the Advanced tab; 'Tablet' and 'Mobile' icons will appear.
    Then click on 'Tablet' and 'Mobile' icon and check your layout on small screens. If necessary, adjust padding/margin values for the responsive mode.
    img
    img

 

 

Blog Template

  1. If you want to create News (or Blog) page, create empty page (Default template),
  2. name it News (or Blog),
  3. go to Settings > Reading and set this page as 'Post page',
  4. adjust number of posts.
    img

 

 

Theme Setup - Admin panel

img

Theme comes with extensive options panel with functions divided to these sections:

img

General Settings:
  1. Upload your Main logo image,
  2. Set header background image for blog and archives,
  3. Enable/disable 'Uppercase' fonts.

img

 

Primary styling:
  1. Select font family (with color, style and width) for main body text,
  2. Choose colors for typographic elements: body, wrapper, containers (ghost color), text/links, hover, borders etc.

img

 

Header Styling & Settings:
  1. Setup color scheme (background, font, links and border colors) for header,
  2. Set other colors for header elements (sub-menus etc.),
  3. Set custom margins and width limitation for logo image.

img

 

Footer Styling:
  1. Select font family with color, style and weight for footer,
  2. Choose colors for typographic elements: footer background, text, links, hover, borders etc.,

img

 

Other Styling:
  1. Set font styling for 'Meta' sections (date, category etc. post information)
  2. Choose background color for elements (buttons, lines etc.),
  3. Select text/link color for elements (buttons, lines etc.),
  4. Set color scheme for image backgrounds.

img

 

 

Headings Typography:
  1. Select Font-family for all headings (h1- h6) and 'post titles',
  2. Select font weight for all headings (h1- h6) and 'post titles',
  3. Select Font-size for all headings (h1- h6) and 'post titles',
  4. Select font color for all headings (h1- h6) and 'post titles',

img

 

Post Settings:
  1. Turn On/Off partial post sections.

img

Social Networks Settings:
  1. Enable "Social Networks" section,
  2. Enter the full URL of social network, your profile or account (enter full URL: http:// or https:// including).

img

 

 

If you are finished click on "Save changes" button!

 

 

 

Custom Posts

 

Slider posts

CityGov theme (+ installed Eleslider plugin) comes with 'Slider' custom posts. Purpose is to create simple image slider:

img

You can access and create Slider custom posts in main dashboard menu:

img

One 'Slider post' represents one slide in the slider.

Slider posts are similar / work similar to the classic posts. You can add slide content (headings, image, texts, button shortcodes etc.), set 'featured image' and sort/list these posts into own categories.

img

 

Display of the slider is very simple, in Elementor use [eleslider] shortcode in 'Text Editor' blockk in the 'full-width column'.

Custom Templates

 

  1. Create a page or a post.
  2. In Page Attributes (Post Attributes) section select custom template ('No Sidebar layout', 'Right Sidebar Layout' etc.)
  3. Click the Publish button to publish your page/post.

 

Custom Widgets

Theme comes with few custom widgets (marked as Themnific).

Go to Appearance > Widgets and setup your sidebar and footer widget areas. Widgets are very easy to setup.

Following widgets are used in theme demo:

img

In theme demo may be used custom widgets which come with 3dr party plugins (Events, Donations, Newsletter etc.).
Please see 'Plugins' chapter for more info about these plugins.

 

 

Images

IMPORTANT! It is possible that after theme activation are images wrongly cropped and look ugly!

In this case use this plugin: http://wordpress.org/extend/plugins/regenerate-thumbnails/ to regenerate old thumbnails from previous theme.
After plugin installation start regeneration in Tools > Regen. Thumbnails This process can take a while and you cannot close tab/window until regeneration is done.

Images and thumbnails are generated automatically.

To display thumbnails correctly upload images via WP interface using "Set featured image" button.
After image upload set featured image.

 

Featured Images - Minimal Sizes
  1. Main Slider section: 1920x900px;
  2. Blog template (Small images): 250x250px;
  3. Single post (as "Header backgorund"): 1500x650px;

 

 

Custom Menu :

 

! Create own custom menus first! Please see following tutorial !

 

Colored Menu Item (on the right)

1. Toggle 'Screen Options' on the top of the menu screen:

2. Enable 'CSS Classes' and 'Desription' option:

3. Toggle any menu item and type special word into 'CSS Classes' field

 

Menu Item Description

Toggle any menu item and type some text word into 'Description' field (see previous steps if the field is not visible/enabled):

Mega menu

Toggle any menu item and type 'mega' word into 'CSS Classes' field (see previous steps if the field is not visible/enabled):

Then just add child menu items.

 

 

Sidebar menu

Create own custom menu in Appearance > Menus and then display this menu in any sidebar using 'Navigation Menu' widget:

 

Menu Icons

 

1. Before (or after) menu label add this piece of code

<i class="fa XXX"></i>

Enter full icon code - 'fa' class is required.

2. For XXX you can set any icon name. You can find all icon names on Font Awesome homepage.

3. You can see how-to video here. It is not tutorial for my theme but the process is the same.

 

Plugins

 

Elementor

Elementor plugin will help you create awesome layouts for your pages.

Go to Appearance » Install Plugins inside wp dashboard and install and activate Elementor plugin.

Basic setup of this plugin is very easy; go to Elementor > Settings and disable default color and fonts:

Save changes and that's it. You can edit any page in the page builder now.

 

Events Manager

Plugin page: Plugin Homepage

Into search field (in Plugins > Add New) insert 'Events Manager' and Install this plugin.

Events manager plugin is very complex and I recommend to check plugin documetation carefully! Please go through 'Getting Started Guide' to learn how to work with the plugin.

Theme related plugin settings:

a) In Events > Setting > Pages select 'Right Sidebar Layout' template for Event and Location pages

b) In Events > Setting > Pages in 'Event List/Archives' section select on which page will used as an events page:

c) In Events > Setting > Formating paste following code into 'Default event list format header' field:

<table class="events-table" >
<tbody>

and this code into 'Default event list format' field:

<tr>
<td class="thumb">
#_EVENTIMAGE{130,130}
</td>
<td class="list_text">
<a href="#_EVENTURL" class="event_button">Find out more</a>
​<h3><a href="#_EVENTURL">#_EVENTNAME</a></h3>
{has_location}
<p class="event_meta">
<span class="ribbon">#_EVENTDATES</span>#_EVENTTIMES at <b>#_LOCATIONNAME</b>
</p>
{/has_location}
</td>
</tr>

close the table markup in the 'Default event list format footer'

</tbody>
</table>

 

d) In Events > Setting > Formating > Single Event Page paste following code into 'Single event page format' field:

<div class="event_header">
#_LOCATIONMAP
<p class="sixcol">
<i class="far fa-clock"></i>
<em>Event Date:</em><br/><strong>#_EVENTDATES</strong> at <strong>#_EVENTTIMES</strong></p>
{has_location}
<p class="sixcol">
<i class="fas fa-map-marker-alt"></i>
<em>Location:</em><br/>
<strong>#_LOCATIONNAME,</strong> <br/>#_LOCATIONADDRESS, <br/>#_LOCATIONTOWN
</p>
{/has_location}
</div> <br style="clear:both" /> #_EVENTNOTES {has_bookings} <h4>Bookings</h4> #_BOOKINGFORM {/has_bookings}

For the date use M d as format

 

 

Give
Donation Plugin and Fundraising Platform

Give plugin will help you create fundraising campaigns.

Into search field (in Plugins > Add New) paste Give and Install this plugin.

1) After installation/activation setp plugin in Donations > Settings:

2) Create own donation form in Donations > All Forms


3) All donation forms can be displayed on one page: Create page name is e.g. 'Cases' ('Get Involved' or 'Donate Now!' like in the theme demo) and select 'Donations' template for this page:

 

 

 

WordPress Download Manager

WordPress Download Manager is a super-awesome downloads manager for WordPress.

Into search field (in Plugins > Add New) paste WordPress Download Manager and Install this plugin. After installation/activation setup plugin in Downloads > Settings and save settings like this:

Add some files (downloads) and display these downloads on any page via shortcodes. You can organize downloads using e.g. [wpdm_category] shortcodes:

[wpdm_package id='XXX'] where XXX is the ID (number) of the file.

[wpdm_category id="development-department"] where 'development-department' is the ID download category.

 

 

MailChimp for WordPress

You can easily create newsletter subscribe form with 'MailChimp for WordPress' Plugin: Plugin Homepage

Into search field (in Plugins > Add New) paste MailChimp for WordPress and Install this plugin

Plugin can be set in MailChimp for WP section:

In demo is used subscribe form with following markup: https://pastebin.com/L2cFPYyP

 

 

Recent Tweets Widget

Theme is compatible with Recent Tweets Widget plugin. Plugin is used in demo site.

In search field (Plugins > Add New) insert 'Recent Tweets Widget' and Install plugin.

Plugin widget can be set in Appearance > Widegts:

Note!: You need to get "consumer and secret" codes for Recent Tweets Widget:

  1. Go to https://dev.twitter.com/apps/new and log in, if necessary
  2. Enter your Application Name, Description and your website address. You can leave the callback URL empty.
  3. Accept the TOS, and solve the CAPTCHA.
  4. Submit the form by clicking the Create your Twitter Application
  5. Copy the consumer key (API key) and consumer secret from the screen into widget fields
Shortcodes Ultimate

You can generate different shortcodes using 'Insert shortcode' button in all Post/Page screens:

img

 

AddToAny Share Buttons

Plugin page: Plugin Homepage

Into search field (in Plugins > Add New) insert 'AddToAny Share Buttons' and Install this plugin.

Plugin can be set in Settings > AddToAny:

Theme is compatible with Simple Share Buttons Adder too.

 

Contact Form 7

Plugin page: Plugin Homepage

Into search field (in Plugins > Add New) insert 'Contact Form 7' and Install this plugin

You can create own contact form(s) in main wp menu > Contact.

You can display created 'contact form' on any page using shortcode. On demo page is used contact fore with following markup: https://pastebin.com/tL2M2PMQ

Please read plugin documentation for more info about this very flexible plugin.

 

Other Recommended Plugins

 

Autoptimize →

Smush →

WP-Members →

WP Featherlight →

Awesome Weather Widget →

 

 

Demo Import (XML file)

 

Make sure that CityGov theme and Elementor and Eleslider plugins are installed and activated before demo import.

If you want to import whole content (inc. events, downloads) activate Events Manager and WordPress Download Manager plugins too!

 

One Click Demo Import

Install and activate 'One Click Demo Import' plugin.

After that import full demo content easily in Appearance > Import Demo Data. img

Choose demo you want to import and then just hit 'Import' button and wait until import is done (it can take few moments).

 

 

 

Elementor templates

If you don't want to import whole demo content you can import just elementor templates (e.g. layout of the homepage) using .json file.

.json files are located in main theme package, in 'spec' folder. Extract .json files to you computer.

img

You can import template when you are editing any page in Elementor > click on 'Add Template' button > Import Template:

img

Find .json file on your computer and import Elementor template.

After that, the template will be available in the 'My Templates' section and you can insert the template into the page you are editing.

When you are inserting template hit 'No' option in the "Import Document Settings" modal window:

img;

 

 

Important!

Due licenses all imported images are for testing purposes only and cannot be used on your live website!!!

You can download free photos for your commercial & personal works on sites like:

http://picjumbo.com/

http://pixabay.com/

https://unsplash.com/grid

 

Translation

This theme is translation/localization ready and comes with citygov.pot file. File is located in ../citygov/lang/ folder.

  1. You need to use localized WordPress installation (core) in the first place:
    img
    If not, localization will be not successful.
  2. Download poedit software here,
  3. Install it and in this software translate citygov.pot file (line by line),
  4. Once you have translated all the strings, you can save this as your .po file.

    The filename of your .po / .mo file is crucial! Gettext uses the ISO 639 standard for language abbreviations and ISO 3166 for locales. If your translation is written in deutsch for example, your file name will look like de_DE.po. Capitalization is also important here. For a full list of language and country codes, check out these two links:

    Once you save, POEdit by default automatically creates a .mo file alongside your .po file. Put these files into 'lang' folder.

  5. Access your wp-config.php file found in your WordPress' root folder. Your file should already contain define('WPLANG', ''); but if it does not, you can add it in. You simply need to add your language and locale code into the define. If you were to translate your theme into German, you would have this:
    define('WPLANG', 'de_DE');

Your internationalization is complete!

 

Right-to-left (RTL) support

 

Step 1 – Test RTL support

Before we make a permanent switch to RTL mode, let’s test it out as an admin – in that way we can safely preview RTL support before making it available to all our website visitors.

Go to Plugins -> Add New and search for “RTL Tester” – or you can grab the plugin over on the WordPress.org repo.

Once you install the plugin you’ll see this new option in your WP toolbar

Once you click “Switch to RTL” the WordPress user interface switches to RTL mode.

 

Step 2 – Make Eleslider RTL ready

Go to Plugins > Plugin Editor and select 'Eleslider'. In right menu find assets/js/owl.carousel.start.js file and add rtl:true, line. save the change.

If you go to your website frontend you should also see that it now displays Right-to-left. Here’s what the CityGov WordPress theme looks like with RTL enabled.

Step 3 – Enable RTL Support permanently

Once you’re happy with how your website looks with RTL mode enabled, it’s time to make the switch permanent.

Hop on over to Settings > General > Site Language – and select your language.

Enabling RTL support in WordPress settings

Hit “Save Changes” and you’re done!

 

 

 

 


Once again, thank you so much for purchasing this theme.

Go To Table of Contents