Introduction

Features

This church theme for WordPress has the features a church website needs — a mobile-friendly responsive design, sermon archive, photo and video gallery, events, multiple location support, staff profiles and church news. The sermon archive is complete with the ability for visitors to browse for audio, video and text sermons by category, tag, date and speaker. Risen also has powerful customization options that make it easy for you to change the theme's colors, fonts and background.

Risen is also useful for non-church websites that need to publish audio or video and promote events. The sermon archive can be fully renamed using the theme options.

Installation

Activation, Sample Content

Installing Risen

Follow these steps to install the theme and import sample data so that your site looks similar to Live Preview. Once you have it setup like the live preview, you can modify it to your heart's content.

  1. Install WordPress
  2. Upload and Activate Theme
    • Log into your WordPress admin and navigate to Appearance > Themes > Install Themes > Upload.
    • Choose risen.zip which is inside of the theme folder in the package you received.
    • Click the install button.
    • After installation, click Activate.
  3. Configure Permalinks (enables friendly URL's)
    • Go to Settings > Permalinks.
    • Choose your preferred URL format ("Day and name" recommended — don't use "Default").
    • Save even if you are sticking with what is already set.
  4. Enable Theme Options
    • Go to Appearance > Theme Options
    • Click the Options Framework link to install and activate the plugin.
  5. Import Sample Content (Optional)
    • Go to Tools > Import > WordPress and install the Importer plugin.
    • Then, click the link to activate and run the importer.
    • Upload sample-content.xml which is inside of the same theme folder that you got the zip file from.
    • Follow the instructions to assign a user to the imported posts.
    • Check the box for Import Attachments in order to import sample images. Note that they are the same dimensions as the live preview images but "grayed out" because the originals cannot be distributed.
    • Continue and the sample content with images will be imported (it can take a couple minutes).
  6. Import Sample Widgets (Optional)
    • Go to Appearances > Widgets and delete the widgets WordPress added to "Blog Sidebar".
    • Go to Plugins > Add New and search for "Widget Settings Importer".
      • Note: As of writing, this plugin does not work with Internet Explorer (use Chrome or Firefox).
    • Click Install Now then activate the plugin after installation.
    • Go to Tools > Widget Settings Import.
    • Upload sample-widgets.json which is inside of the theme folder.
    • Select and import all of the sample widgets.
    • Return to Appearances > Widgets to confirm that the widgets are there (if any are missing, you can re-import only those widgets).

Now when you view your site, it should look like the Live Preview but with gray versions of the images. Use this setup as a starting point for your own content.

Note that after installation the contents of risen.zip end up in the wp-content/themes/risen directory of your WordPress installation. WordPress simply extracts the files from the zip archive.

Theme Upload Help

In Step 2 you may have received an error while attempting to upload the theme zip file that said the file was too big. Different hosts have different maximum file upload sizes and sometimes their limit is smaller than a WordPress theme. As a result, the theme (and other files of similar size) cannot be uploaded via the WordPress admin area. Choose a method below to remedy the problem.

Manual FTP Upload

The original way to install a WordPress theme is simply to upload it via FTP. If you are new to web hosting, find your host's guide on using FTP.

  1. Unzip risen.zip. The result will be a risen folder containing the theme files.
  2. FTP into your web server.
  3. Navigate to the wp-content/themes directory.
  4. Upload the risen folder you unzipped to this location.
  5. Log into your WordPress admin and go to Appearance > Themes.
  6. Activate the Risen theme.
  7. Return to Step 3 of the installation process above.

Ask Your Web Host to Raise the Limit

The simplest solution is often to ask your web host to raise your upload file size limit. Tell them how big the theme zip file is and that you are trying to upload via WordPress but receive an error. Tell them what the error message you received says.

Change the Limit Yourself

Some web hosts let you change the file upload size limit yourself. For the best instructions, search your web host's knowledgebase for a guide on raising your upload file size limit. For a more general guide, read How to Increase the Maximum File Upload Size in WordPress at WPBeginner.

Updating

Applying Updates

This theme may be updated periodically in order to add new features and fix bugs. You can always check to see what the latest version is by viewing the latest changelog in the online documentation. As a customer, you can download the most current version from your ThemeForest account. You can subscribe to the our Newsletter or follow us on Twitter (@churchthemes) to get update notices.

Important Notes: Read First

  1. Updating a theme should not affect the content of your website. However, as with updating WordPress itself, it is a good idea to make a complete backup of your website first (including your WordPress installation, old theme, database, everything).
  2. If you have made changes to the theme's code, an update will overwrite them. It is always recommended to use a Child Theme for customizations so that you do not lose changes when updating.
  3. If you have made a Translation for the theme, your translated text is stored inside the theme's languages folder (unless you moved it to a child theme, which is recommended). Make a backup of this folder before updating so you can restore it after updating. Note that an update may change or introduce new text that you may want to translate.

Updating Automatically

Envato (makers of ThemeForest) have developed the Envato Toolkit Plugin for WordPress. You can use this to receive notification of updates to themes purchased from ThemeForest and to automatically update (upon clicking) directly from within your WordPress admin area.

  1. Download the plugin zip file to your computer.
  2. In your WordPress admin area, go to Plugins > Add New then click Upload.
  3. Click Choose File, select the plugin zip file you downloaded and click Install Now.
  4. After installation, click Activate.
  5. Click the new Envato Toolkit link in the menu and follow the instructions to configure the plugin.

Updating Manually

  1. Download the most current version from ThemeForest in the "Downloads" area of your account.
  2. Unzip the package and locate risen.zip in the theme folder.
  3. Go to Appearance > Themes and activate another theme such as the default WordPress theme.
  4. Delete the Risen theme which is now inactive.
  5. Go to Install Themes > Upload then install and activate risen.zip from the new package.

You can also update via FTP. Just replace wp-content/themes/risen with the new theme (the contents of risen.zip).

Theme Options

Custom Settings

Risen's theme options are available under Appearance > Theme Options. Upon your first visit, you will be instructed to install the Options Framework plugin. The following options are available. Instructions are provided by each option in your WordPress admin.

  • Styles - Colors, fonts and background
  • Header - Logo upload and social icons
  • Footer - Social icons, address, phone and copyright
  • Homepage - Custom <title>, slider options, intro message
  • Sermons (Multimedia) - "Multmedia" wording, items per page, page titles, header options
  • Gallery - Categories order, items per page, header options, category title
  • Events - Items per page, header option
  • Blog (News) - Header options, page titles
  • Contact Form - Contacts, CAPTCHA
  • Other - Subpage <title>, breadcrumb path, Google Analytics, favicon, Google Maps API key

Customization

Logo, Colors, Fonts

Risen was made to be easy to customize. Here are some things you can change and where/how to do so.

Logo

You can upload your logo by going to Appearance > Theme Options > Styles.

If you want to use the logo included with Risen, you can edit one of the included PSD Files using Photoshop in order to insert the name of your church or website. If you do not have access to Photoshop, you can create your own logo image using a free graphics editor like GIMP.

Tagline

The tagline shown on the right side of the header can be changed by going to Settings > General.

Colors

You can choose between a light or dark base style and set custom main color (menu bar, slider caption, sidebar widget headings, etc.) and link color in Appearance > Theme Options > Styles. You can also change the background color (read below).

Background

Risen gives you complete control over the background. Here are the types of backgrounds you can configure in Appearance > Theme Options > Styles.

Solid Color

Choose any color to show as your background.

Preset Background

Several preset background images and patterns are included with Risen, including those shown in the Live Preview. Some of the background patterns are colorable.

Custom Upload

You can upload your own background image. There are options for showing it full screen (such as a large photo) as well as for making your background tile (like a pattern).

Fonts

Go to Appearance > Theme Options > Styles to change the fonts uses for the menu, headings and body text. You can use the default fonts or choose from about 200 hand-picked Google Web Fonts.

Social Icons

You can show social icons for Twitter, Facebook, Google+, Pinterest, YouTube, Vimeo, Flickr, StumbleUpon, Tumblr, LinkedIn, Skype, Dribbble, Forrst and RSS in the header and footer. To do this go to Appearance > Theme Options then Header or Footer. Note that depending on the size of your main menu, your space for social icons ma be limited in the header. The footer has room to display all social icons.

Footer Text

Go to Appearance > Theme Options > Footer to change the address, phone and copyright text in the footer (feel free to remove "Powered by churchthemes.com"). Read Navigation for how to configure your footer menu.

Favicon

A favicon is a small icon representing your site that shows in the address bar, bookmarks, etc. If you have one, you can upload it by going to Appearance > Theme Options > Other.

Translation

Risen is translation-ready. A PO file is included in the theme's languages folder. You can use this file to translate all text in the theme into your own language. Read the Translation section for a complete guide.

Non-church Sites

Risen was made to be useful for non-church sites that want to present multimedia and/or events. Throughout the theme generic names are used. The church and sermon references in the live preview are contained within content, not in the theme. Follow these steps to setup Risen for use as a non-church website.

  1. Go to Appearance > Theme Options > Sermons and change the "Multimedia" wording from "Sermon" to "Multimedia" or "Presentation", for example.
  2. In Appearance > Theme Options > Footer check the box for "Use generic icon"

If you imported sample content, also complete these steps:

  1. Go to Pages > All Pages and Edit the "Sermon Archive" page's title.
  2. Go to Appearance > Menus and change any sermon links.
  3. In Appearance > Widgets and rename any instances of sermon widgets.

Advanced Customization

If you want to edit the theme's stylesheets, JavaScript, PHP templates or other code, it is recommended that you do so using a child theme. This is so you can safely upgrade the Risen parent theme, if necessary, without overwriting your customizations (because they are safe and separate in the child theme). Read the Child Theme section for a starter guide.

For editing graphics used in the theme's design you can take advantage of the layered PSD Files that are included. You can also use these files to change the text of the logo.

Related Guides

Homepage

Slider, Intro, Widgets

You can customize Risen's homepage with a slider, intro message, featured boxes and widgets.

Slider

Adding a Slide

  1. Go to Home Slider > Add New.
  2. Click Set featured image then Upload Files, upload an image, select it, then click Set featured image.
  3. Optionally add a Caption, Click URL and Video URL (instructions shown by fields).
  4. Under Attributes enter a number representing the Order in which you want the slide to appear.

The slide image you upload should be at least 960x350 (if larger, it will be auto-cropped). If you upload an image that is less than 960 pixels wide, it will appear stretched in the slider. In this case, you should provide a larger image.

Editing and Deleting Slides

  1. Go to Home Slider > All Items
  2. Hover over a slide item to see the Edit and Trash options

Note that this will delete the slides but the actual image files will remain on your server. If you want to delete the image files, go to the WordPress Media Library (Media Files > Library).

Slider Options

Go to Appearance > Theme Options > Homepage to disable the slider, change whether or not slides should transition from one to next automatically and set the number of seconds between automatic slide changes.

Intro Message

You can change the text in the box below the slider by going to Appearance > Theme Options > Homepage and editing the "Intro Message" field. If you do not want to show an intro message, simply delete the text then save.

Featured Boxes

The Live Preview shows three boxed images with titles below the intro message. You can use these to direct the visitor's attention to the most important areas of your site.

Adding a Box

  1. Go to Home Boxes > Add New.
  2. Click Set featured image then Upload Files, upload an image, select it, then click Set featured image.
  3. Optionally enter a Title and Click URL (instructions shown by fields).
  4. Under Attributes enter a number representing the Order in which you want the box to appear.

Provide an image that is at least 640x480 (it will be cropped/resized) for the best experience on mobile devices.

It is possible to add more than three boxes. If you do so, the additional boxes will be shown in additional rows.

Editing and Deleting Boxes

  1. Go to Home Boxes > All Items
  2. Hover over a box item to see the Edit and Trash options

If you do not want to show boxes, simply delete them all.

Bottom Widgets

You can show any widget at the bottom of the homepage either in a left-hand or right-hand column. These widget areas are handy for showing recent news, sermons, events, etc. See the Live Preview for ideas.

  1. Go to Appearance > Widgets.
  2. Click on Home Bottom Right and Home Bottom Left to expand those widget areas.
  3. Drag any widget into either of those widget areas.
  4. Configure each of your widgets as desired.

If you do not want to show widgets at the bottom of the homepage, delete them from the Home Bottom Right and Home Bottom Left areas. Alternatively you can drag them to the "Inactive Widgets" area.

Read the Widgets guide for more information.

Any Page as Homepage

You can use WordPress's Static Front Page feature to use any page as the homepage. This includes pages using a page template. For example, you can use a page that uses the Blog template as the homepage in order to use the theme for a pure blog.

  1. Go to Settings > Reading
  2. Set Front page displays to a static page

Pages

Content, Header, Templates

You can add pages to your site with any content or use a custom page template to show special content such as sermons, events, gallery, staff and locations.

Adding a Page

This is how to add a basic page.

  1. Go to Pages > Add New.
  2. Enter a title and content.
  3. Click Publish

Note that you can click Screen Options at the top-right to reveal more options for preparing the page. Some options are hidden by default.

Editing and Deleting Pages

  1. Go to Pages > All Pages
  2. Hover over a page to see the Edit and Trash options

Header Image

Using a Header Image

You can optionally add a header image to a page. When adding or editing a page:

  1. Click Set featured image.
  2. Click Upload Files.
  3. Upload an image.
  4. Select the uploaded image.
  5. Click Set featured image to use it.

The image you upload should be at least 960x250 (if larger, it will be auto-cropped). If you upload an image that is less than 960 pixels wide, it will appear stretched in the header. In this case, you should provide a larger image.

Page Header Override

Sometimes you may want a page to use the header image and title from another page. This is handy in instances when you want to create a "section" of pages that all have the same header.

Look for the Page Header Override option when adding or editing a page.

Custom Page Templates

Risen uses page templates to show special content such as the sermon archive, events, locations, etc. Look for the Page Attributes box which has a Template selector when adding or editing a page.

  • Blog - Lists all Blog posts from new to old
  • Contact - Uses the the Contact Sidebar for widgets. Provides no content. Read the Contact Page guide.
  • Events - Lists your events. Read the Events guide.
  • Gallery - Categories - Lists all Gallery categories.
  • Gallery - All Images & Videos - Lists all Gallery images and videos.
  • Gallery - All Images - Lists all Gallery images (no videos).
  • Gallery - All Videos - Lists all Gallery videos (no images).
  • Locations - Lists all Locations
  • Multimedia - Lists all Sermons from new to old
  • Staff - Lists all Staff members

Any content that you enter will appear above the content produced by the page template. For example, you could write a brief message about your team in the content box then choose the Staff template. When viewing the page, the result would be your staff members appearing below the message you wrote.

Sidebar Widgets

You can show an optional sidebar with Widgets on the right side of your pages. When adding or editing a page:

  1. Check the Show sidebar widgets box and save
  2. Go to Appearances > Widgets
  3. Click Page Sidebar to expand it
  4. Drag any widgets you want into the sidebar

If your page is using a custom page template then it has its own sidebar that you can drag widgets into. For example, if you create a page using the Events template then it uses the Events Sidebar. Only pages without a template use the default Page Sidebar.

Read the Widgets guide for more information.

Adding Pages to Menus

After adding a new page you will probably want to add it to your menu. Read the Navigation guide for instructions.

Multimedia (Sermons)

Audio, Video, Text, PDF

Risen has a set of multimedia features that helps you publish sermons in audio, video or text format.

Sermons Page

First you need to create a page that acts as an entry to the sermon archive by listing all sermons from new to old.

  1. Go to Pages > Add New.
  2. Enter a title and any content that you want to appear at the top of the sermon archive.
  3. Under Page Attributes choose the Multimedia template.
  4. Optionally configure a header image and sidebar (read the Pages guide).
  5. Click Publish.

Sermon Categories

You can organize sermons into categories.

Add a Category

  1. Go to Sermons > Categories
  2. Enter a category name
  3. Click the Add Category button

Edit and Delete Categories

  1. Go to Sermons > Categories
  2. Hover over a category to see the Edit and Delete options

Notice also that there is a Sermons column with a number by each category. This shows you how many items are in each category. If you click the number, it will show you the items.

Publishing Sermons

Adding a Sermon

Risen uses a custom post type that makes it easy for you to add sermon items.

  1. Go to Sermons > Add New
  2. Click Screen Options at the top-right then check all boxes.
  3. Enter a title for the sermon.
  4. Provide any combination of the following sermon content.
    • Text - Enter full sermon text into the main content box. Under Media check the Show "Text" Icon box.
    • Video - Under Media provide a YouTube or Vimeo URL. You can upload your video for free.
    • Audio - Under Media provide an MP3 Audio File by entering a URL or uploading a file.
    • PDF - Under Media provide a PDF File by entering a URL or uploading a file.
  5. Enter two or three sentence Excerpt describing your sermon.
  6. Select or add the categories you want this sermon to appear in.
  7. Select or add the speaker(s) who presented this sermon.
  8. Optionally enter tags (keywords) that match this sermon.
  9. Click Set featured image then Upload Files, upload an image, select it, then click Set featured image.
  10. Optionally check the Show sidebar widgets box if you want to show a sidebar on this sermon's page.
  11. Click the Publish button to add it.

Editing and Deleting Sermons

  1. Go to Sermons > All Items
  2. Hover over a gallery item to see the Edit and Trash options

Large File Uploads

MP3 files and sometimes PDF files are often large files. Most web hosts by default limit the size of files that can be uploaded so if their limit is 2 MB and your MP3 file is 10 MB then the upload will fail. Therefore, if you are uploading a large file when publishing a sermon, you may receive a message saying something like "The uploaded file exceeds the upload_max_filesize directive in php.ini." There are several ways of dealing with this issue.

But first, make sure the MP3 file you are uploading is sufficiently compressed. If it is several hundred megabytes for one hour then it is unnecesarily large. It is reasonable to expect a one hour MP3 to be under 20 MB.

Ask Your Web Host (Recommended)

The simplest and best solution is usually to ask your web host to raise your upload file size limit. Tell them how big the files you want to upload are and that you are trying to upload them via WordPress but receive an error. Tell them what error message you received says.

Change the Limit Yourself

Some web hosts let you change the file upload size limit yourself. For the best instructions, search your web host's knowledgebase for a guide on raising your upload file size limit. For a more general guide, read How to Increase the Maximum File Upload Size in WordPress at WPBeginner.

Manual FTP Upload

If your host will not allow you to upload larger files via WordPress, you can upload them using FTP. If you are new to web hosting, find your host's guide on using FTP. A good place to store them is in WordPress's wp-content/uploads directory. After uploading your MP3 file, provide the URL to it in the MP3 Audio File when adding/editing a sermon. Note that manual file uploads via FTP will not appear in your WordPress media library unless you run a plugin like Add From Server.

Sermon Options

Go to Appearance > Theme Options > Sermons to set these options.

  • "Multimedia" Wording - For a non-church site you can change "Sermon" to "Multimedia" or "Presentation".
  • Items Per Page - The number of sermons to show per page before page navigation controls kick in.
  • Header Image - Choose to show the header image from the page using the Multimedia template on category, speaker, tag, date archive and single sermon pages.
  • Page Title Formats - Customize the format of page titles for category, tag, speaker and date archive areas.

Sermon Widgets

You can go to Appearance > Widgets and drag widgets into the Sermon Sidebar.

You can show any widgets in a sidebar but there are several widgets especially useful for the sermon sidebar. The Recent Sermons widget is also useful for showing new sermons on the homepage.

  • Categories (Enhanced) - For listing your sermon categories or speakers.
  • Tag Cloud - Standard WordPress widget that can list sermon tags.
  • Sermon Archives - Lists monthly date archives for sermons.
  • Recent Sermons - Lists the most recent sermons.

Read the Widgets guide for more information.

Events

Church Calendar

You can create a church calendar by using the events post type and Upcoming/Past Events page templates.

Events Page

First you need to create a page that will show the events that you add.

  1. Go to Pages > Add New.
  2. Enter a title and any content that you want to appear at the top of the events list.
  3. Under Page Attributes choose the Events - Upcoming template.
  4. Optionally configure a header image and sidebar (read the Pages guide).
  5. Click Publish.

There is also an Events - Past page template that you can use to show events that are over.

Managing Events

Adding an Event

Risen uses a custom post type that makes it easy for you to add events.

  1. Go to Events > Add New.
  2. Click Screen Options at the top-right then check all boxes.
  3. Enter a title for the event.
  4. Use the content box to write information about the event.
  5. Fill in the details under Date & Time (Start Date is required).
  6. Fill in the optional details under Location (venue, address, map).
  7. Write a short Excerpt summarizing the event.
  8. Click Set featured image then Upload Files, upload an image, select it, then click Set featured image.
  9. Optionally check the Show sidebar widgets box if you want to show a sidebar on this event's page.
  10. Click the Publish button to add it.

Editing and Deleting Events

  1. Go to Events > All Events
  2. Hover over an event to see the Edit and Trash options

Hide Events When Expired

By default, when an event passes it will still show on site with an "event has expired" message for historical purposes. If you would like events that are over to be hidden, you can use the Electric Studio Auto Post Expire plugin to automatically set an event to "Draft" status on a certain date.

Widgets

Events Sidebar

If you enabled the sidebar for your events page or any of your event items, you can show widgets in it. To do this go to Appearance > Widgets and drag any widgets into the Events Sidebar

Upcoming Events Widget

Risen includes a widget for showing upcoming events. In the Live Preview it is shown on the homepage but it can be shown in sidebars too.

Read the Widgets guide for more information.

Staff

Profiles

You can create a list of staff profiles complete with photo and e-mail button.

Staff Page

First you need to create a page that will show the staff members that you add.

  1. Go to Pages > Add New.
  2. Enter a title and any content that you want to appear at the top of the staff list.
  3. Under Page Attributes choose the Staff template.
  4. Optionally configure a header image and sidebar (read the Pages guide).
  5. Click Publish.

Managing Staff

Adding Staff

Risen uses a custom post type that makes it easy for you to add staff.

  1. Go to Staff > Add New.
  2. Click Screen Options at the top-right then check all boxes.
  3. Enter the staff member's name in the title field.
  4. Write their bio in the content box.
  5. Optionally enter their Position (e.g. Senior Pastor) under Details
  6. Optionally configure the E-mail Button under Details (read Contact Page for more details)
  7. Click Set featured image then Upload Files, upload an image (at least 180x180), select it, then click Set featured image.
  8. Click the Publish button.

Editing and Deleting Staff

  1. Go to Staff > All Staff
  2. Hover over a staff member to see the Edit and Trash options

Widgets

Staff Sidebar

If you enabled the sidebar for your staff page, you can show widgets in it. To do this go to Appearance > Widgets and drag any widgets into the Staff Sidebar

Staff Widget

Risen includes a widget for showing staff. As an example, in the Live Preview it is shown on the contact page.

Read the Widgets guide for more information.

Locations

One or Multiple

You can publish one or multiple locations using Risen's locations post type and page template. If you have one location you can use this feature or you may want to simply show a map and contact details on the Contact Page.

Location(s) Page

First you need to create a page that will show the location(s) that you add.

  1. Go to Pages > Add New.
  2. Enter a title and any content that you want to appear at the top of the location(s) list.
  3. Under Page Attributes choose the Locations template.
  4. Optionally configure a header image and sidebar (read the Pages guide).
  5. Click Publish.

Managing Locations

Adding a Location

Risen uses a custom post type that makes it easy for you to add locations.

  1. Go to Locations > Add New.
  2. Click Screen Options at the top-right then check all boxes.
  3. Enter a title for the location.
  4. Use the content box to write information about the location (such as service times).
  5. Fill the fields under Location Details (address, phone, e-mail button, map).
  6. Click the Publish button to add it.

For more information on the E-mail Button read the Contact Page guide.

Editing and Deleting Locations

  1. Go to Locations > All Locations
  2. Hover over an event to see the Edit and Trash options

Widgets

Locations Sidebar

If you enabled the sidebar for your locations page, you can show widgets in it. To do this go to Appearance > Widgets and drag any widgets into the Locations Sidebar

Locations Widget

Risen includes a widget for showing locations. In the Live Preview it is shown on the contact page. It can be shown in any of the widget areas such as the homepage or another.

Read the Widgets guide for more information.

Contact Page

Contact Form, Map

You can create a contact page with a contact form, map and information (address, phone, service times, etc.)

Contact Sidebar

If you want to show a sidebar on your contact page do these two things when adding or editing the page.

  1. Under Page Attributes select the Contact template
  2. Under Sidebar check the Show sidebar widgets box

After doing this, the widgets you drag into the Contact Sidebar in Appearance > Widgets will appear. The Live Preview shows how you can show Staff and Locations widgets in the sidebar.

Google Map

You can show your location on a Google Map using Risen's Google Maps shortcode. This shortcode can be used on any page, not just your contact page. Use the shortcode anywhere in your contact page's content.

Shortcode Attributes

The [google_map] shortcode accepts these attributes. The longitude and latitude are required. You can convert your address into latitude and longitude coordinates by using a website like Get Lat Lon.

  • latitude (required)
  • longitude (required)
  • type - roadmap, satellite, hybrid (default) or terrain
  • zoom - 1 – 21 (14 is default). A lower number is more zoomed out while a higher number is more zoomed in.
  • border - yes (default) or no
  • height_percent - Height percent in relation to width. 50% would make the height half of what the width is.

Basic Shortcode Example

This will show a map using default attributes. The result is a rectangular road/satellite hybrid map with border and moderate zoom level.

[google_map latitude="33.663960772925115" longitude="-117.64387607574463"]

Advanced Shortcode Example

This will show the same location but with a roadmap appearance (no satellite imagery), stronger zoom level, no border and having a height that is 100% of the width (in other words, the map is square).

[google_map latitude="33.663960772925115" longitude="-117.64387607574463" type="roadmap" zoom="18" border="no" height_percent="100"]

Contact Form

Risen's contact form lets visitors send e-mail messages to you. It can be configured to allow the visitor to select a recipient (church office, specific staff member, campus location, etc.).

Contact Form Shortcode

The contact form will appear where you use the [contact_form] shortcode in your page content.

Configuring Contacts

Go to Appearance > Theme Options > Contact Form and enter at least one contact (name and e-mail address). If you configure multiple contacts, the visitor can select who to send the message to.

A contact should be entered in this format:

Name, example@emailaddress.com

For multiple contacts, enter one per line. Here is an example.

Church Office, office@somechurch.com
Bob Smith (Senior Pastor), pastor@somechurch.com
Gary Jones (Executive Pastor), gary@somechurch.com
Julie Johnson (Pastor's Assistant), julie@somechurch.com
North Campus, north@somechurch.com
South Campus, south@somechurch.com

Note that if you ever change one of the contact's name or e-mail address, you will need to re-configure any Staff or Location items that use that contact for their E-mail Button.

reCAPTCHA Spam Protection

You can add a reCAPTCHA box to the contact form to help prevent spam submissions.

  1. Sign up for a reCAPTCHA Key.
  2. Go to Appearance > Theme Options > Contact Form to enter your public and private keys.

E-mail Buttons

When adding or editing a Staff or Location item, you have the option of configuring an E-mail Button. You enable the button by selecting your contact page (where the [contact_form] shortcode is used) and one of the contacts specified in theme options. When the button is clicked, the visitor will be taken to the contact page and the contact form will scroll into view with the appropriate contact pre-selected for them.

Preselecting "To"

You can link to your contact page and cause a "To" contact to be pre-selected by appending a contact parameter to your URL. Here is an example:

http://yoursite.com/contact/?contact=5ee23a091108723326bc93b10bdc8c0b

The contact parameter is an md5 hash of the contact's e-mail address, in order to obscure it from spammers. You can convert an e-mail address into an md5 hash by using a generator such as this: http://www.md5hashgenerator.com/.

Related Guides

Blog

Church News

Risen is a WordPress theme so naturally it has blogging capabilities. You can use the blog features for church news.

Blog Page

First you will need to add a page to show your blog index. It will list all posts from new to old.

  1. Go to Pages > Add New.
  2. Enter a title (such as "Blog" or "Church News") and any content that you want to appear at the top of the blog.
  3. Under Page Attributes choose the Blog template.
  4. Optionally configure a header image and sidebar (read the Pages guide).
  5. Click Publish.

Adding a Post

  1. Go to Blog Posts > Add New.
  2. Click Screen Options at the top-right and enable any missing boxes.
  3. Enter a post title.
  4. Enter the post content.
  5. Write a short excerpt (post summary).
  6. Choose the categories you want to add your post to (you can click Add New Category if necessary).
  7. Optionally enter some tags (keywords) for your post.
  8. Optionally click Set featured image then Upload Files, upload an image (auto-resized), select it, then click Set featured image.

Editing and Deleting Posts

  1. Go to Posts > All Posts
  2. Hover over a post to see the Edit and Trash options

Editing and Deleting Categories and Tags

  • Go to Posts then Categories or Tags.
  • Hover over an item to see the Edit and Delete options.

Blog Options

The following options exist in Appearance > Theme Options > Blog.

  1. Header Image - Choose to show the same header image that the page using the Blog template uses on single posts and category, tag, date archive, author and search pages.
  2. Page Title Formats - Customize the format of category, tag, date archive, author and search page titles.

Other blog settings are handled natively in the WordPress settings. Go to the WordPress Settings menu to change date formats, posts per page, permalink URL's, comments, etc.

Blog Widgets

You can go to Appearance > Widgets and drag widgets into the Blog Sidebar.

You can show any widgets in a sidebar but there are several widgets especially useful for the blog sidebar. The Recent Posts (Enhanced) widget is also useful for showing new sermons on the homepage.

  • Search - Show a search form for searching posts.
  • Categories (Enhanced) - For listing your blog categories.
  • Tag Cloud - Standard WordPress widget that can list blog tags.
  • Recent Posts (Enhanced) - Lists blog posts with options for author, date, excerpt and image.
  • Recent Comments - Show recent comments made on posts.
  • Archives - Lists monthly date archives.
  • Calendar - Show a mini calendar for navigating to posts by day.

Read the Widgets guide for more information.

Author Boxes

You can show an author box below each post and at the top of each author's archive. The box shows the author's name, Gravatar image and a short bio.

  1. Go to Users > All Users.
  2. Click to edit a user.
  3. Provide text in the Biographical Info field.

RSS Icon

You can show an RSS icon in the header and footer that links to your blog feed. Go to Appearances > Theme Options > Header (or Footer) to configure this.

Feedburner

If you use the Feedburner service, install a plugin such as FeedBurner FeedSmith Extend to cause WordPress to redirect your RSS feed URL to your Feedburner URL.

Social Bookmarking

Read Recommendations for a plugin that will add Facebook, Twitter, etc. buttons to your posts, sermons, etc.

Widgets

Widgets & Sidebars

Widgets are compact blocks of content that can be shown on the homepage or on the side of pages and posts.

Widget Areas

Homepage

You can show widgets at the bottom of the homepage. Read the "Bottom Widgets" section in the Homepage guide for information.

  • Home Bottom Left - Left-hand column at the bottom of the homepage.
  • Home Bottom Right - Right-hand column at the bottom of the homepage.

Sidebars

Pages, blog posts, sermons, events and gallery items have an option for enabling a sidebar. When a sidebar is enabled, it will show the widgets that you have configured it to show. Different areas have different sidebars that you can add different widgets to. The various sidebars are listed below.

  • Page Sidebar - Pages not using a page template use this sidebar.
  • Blog Sidebar - Page using the Blog template, categories, date archives, single posts, etc.
  • Sermon Sidebar - Page using the Multimedia template, categories, tags, speakers, single sermons, etc.
  • Gallery Sidebar - Pages using a gallery template, gallery categories, gallery items.
  • Events Sidebar - Page using the Events template and single events.
  • Staff Sidebar - Page using the Staff template.
  • Locations Sidebar - Page using the Locations template.
  • Contact Sidebar - Page using the Contact template.

Custom Widgets

Risen has the following custom widgets that can be used in the areas listed above.

  • Categories (Enhanced) - Lists blog categories, gallery categories, sermon categories or sermon speakers.
  • Sermon Archives - List monthly date archives for sermons.
  • Recent Sermons - Lists X sermons with options for speaker, date, icons, excerpt and image.
  • Recent Gallery Items - Show X photos and/or videos from any or all categories.
  • Recent Posts (Enhanced) - Lists X blog posts with options for author, date, excerpt and image.
  • Upcoming Events - Lists X events with options for date, time, excerpt and image.
  • Locations - Lists X locations with options to show map, address and phone.
  • Staff - Lists X staff members with options to show photo and position.
  • Donation - Shows a message with button taking user to URL of your choice (such as PayPal).

WordPress also has a set of standard widgets that are useful for doing such things as showing a tag cloud, recent blog posts and recent comments.

Configuring Widgets

First make sure the page, post or other item you want to show widgets on has its sidebar enabled. To do this, edit a page, post, sermon, event, etc. and make sure the Show sidebar widgets box is checked. Here are directions for adding a widget to a widget area.

  1. Go to Appearance > Widgets.
  2. Click on a widget area to expand it.
  3. Drag a widget into the widget area.
  4. Click the widget inside of its widget area to set its options.

Sample Widgets

A sample widgets file is included with Risen. You can import this file to have the same widgets you see in the Live Preview. Read the Installation guide for instructions.

Child Theme Note

If you are going to make customization by switching to a Child Theme, be aware that the widgets you have configured in the parent theme will not be available in the child theme. You can manually reconfigure them or use the Widget Settings Importer/Exporter plugin to export them when using the parent theme then import them after switching to the child theme.

Shortcodes

Buttons, Columns, etc.

Please Read: If shortcodes are not working, you are probably using an older version of the theme and will need to Update to the latest version to use them. Also note that a bug with shortcodes affecting third party plugins was fixed in version 1.1.2 (September 21, 2012). Please update to the latest if your version is older.

Risen includes a set of responsive shortcodes. View the shortcodes in action on the live preview. You can use these within your post and page content to create tabbed content, buttons, columns, maps, quotes and more.

Tabbed Content

Wrap multiple [tab] shortcodes with the [tabs] shortcode.

[tab] Attributes

  • title (required) - title of the tab
  • active - set to true to show tab's contents by default instead of first tab

Example

[tabs]

	[tab title="First Tab"]
		First tab content here.
	[/tab]
	
	[tab title="Second Tab" active="true"]
		Second tab's content. This tab's content will be shown on page load.
	[/tab]

[/tabs]

Accordion

Wrap multiple [accordion_section] shortcodes with the [accordion] shortcode.

[accordion_section] Attributes

  • title (required) - Title of the section
  • active - Set to true to show section's contents by default

Example

[accordion]

	[accordion_section title="First Section" active="true"]
		First section's content here. This section will be opened on page load.
	[/accordion_section]
	
	[accordion_section title="Second Section"]
		Second section's content here.
	[/accordion_section]

[/accordion]

Buttons

The [button] shortcode can be used to make small and large buttons of various colors.

[button] Attributes

  • url (required) - URL to go to when button is clicked
  • color - Hex code or red, orange, yellow, green, teal, blue, purple, pink, brown, tan, silver, gray, black
  • size - small (default) or large
  • width - Numeric value representing pixels or auto to fit button size to text
  • textcolor - white (default) or black, mainly for use when specify hex code color
  • newwindow - Set to true to open link in new window
  • class - Class or classes separated by spaces

Examples

[button url="http://www.iamsecond.com"]Button Text[/button]

[button url="http://www.iamsecond.com" size="large" color="green"]Big Green Button[/button]

[button url="http://www.iamsecond.com" newwindow="true"]Open in New Window[/button]

Boxes

You can wrap content with the [box] shortcode and optionally show an icon (great for alerts).

[box] Attributes

  • icon (optional) - alert, check, down, info, or x

Examples

[box]
Content to appear in box goes here.
[/box]

[box icon="info"]
This text appears by an "info" icon inside a box.
[/box]

Columns

You can use column shortcodes to place content in columns of various widths. The column shortcodes are [one_fourth], [one_third], [one_half], [two_thirds] and [three_fourths]. These can be mixed and matched and must be encapsulated by the parent [columns] shortcode.

Responsive Columns

Basically, on devices smaller than an iPad (phones and small tablets), the columns adjust to show one on top of each other. Otherwise, the content in them will be difficult to read (for example, try imagining four columns side-by-side on a screen as small as a mobile phone).

Two Column Example

Remember, wrap the column shortcodes in [columns] or they will not work properly.

[columns]

	[one_half]
		This content will fill 50% of the content area.
	[/one_half]

	[one_half]
		This content will fill 50% of the content area.
	[/one_half]

[/columns]

Three Column Example

[columns]

	[one_third]
		This content will fill one-third of the content area.
	[/one_third]

	[one_third]
		This content will fill one-third of the content area.
	[/one_third]
	
	[one_third]
		This content will fill one-third of the content area.
	[/one_third]

[/columns]

Four Column Example

[columns]

	[one_fourth]
		This content will fill 25% of the content area.
	[/one_fourth]

	[one_fourth]
		This content will fill 25% of the content area.
	[/one_fourth]
	
	[one_fourth]
		This content will fill 25% of the content area.
	[/one_fourth]
	
	[one_fourth]
		This content will fill 25% of the content area.
	[/one_fourth]

[/columns]

Mix & Match Example

You can mix and match column shortcodes of different sizes. Just make sure the total width does not exceed 100%.

[columns]

	[one_third]
		This content will fill one-third of the content area.
	[/one_third]

	[two_thirds]
		This content will fill two-thirds of the content area.
	[/two_thirds]

[/columns]

Quotes

If you want to show a simple blockquote you can skip this shortcode and click the quote icon in WordPress's content editor. If you want to do more such as show a name with the quote or float it off to one side as a pullquote, then the [quote] shortcode is useful.

[quote] Attributes

  • name - Name or source of the quote, shown below it
  • center - Set to true to center the quote text
  • float - right or left (set size when using this)
  • size - one-third, one-half or two-thirds

Basic Example

[quote name="Johnny Doe"]
Here is a demonstration of a quote having only the name option set. This is
a standard quote with a name. You could, if you want, leave the name out and
center it. The options for floating left or right and width are mainly for
creating a pullquote. Have a look below for an example of that.
[/quote]

Pullquote Example

[quote name="John Smith" center="true" float="right" size="one-third"]
This is a pullquote floated to the right of the text below with one-third width
and centered text.
[/quote]

Whatever text you place here is the text that the pullquote will be shown to
the right of.

Google Map

You can embed a custom Google Map using the [google_map] shortcode.

[google_map] Attributes

Tip: Use Get Lat Lon or a similar website to convert your address into latitude and longitude coordinates.

  • latitude (required)
  • longitude (required)
  • type - roadmap, satellite, hybrid (default) or terrain
  • zoom - 1 – 21 (14 is default). A lower number is more zoomed out while a higher number is more zoomed in.
  • border - yes (default) or no
  • height_percent - Height percent in relation to width. 50% would make the height half of what the width is.

Basic Shortcode Example

This will show a map using default attributes. The result is a rectangular road/satellite hybrid map with border and moderate zoom level.

[google_map latitude="33.663960772925115" longitude="-117.64387607574463"]

Advanced Shortcode Example

This will show the same location but with a roadmap appearance (no satellite imagery), stronger zoom level, no border and having a height that is 100% of the width (in other words, the map is square).

[google_map latitude="33.663960772925115" longitude="-117.64387607574463" type="roadmap" zoom="18" border="no" height_percent="100"]

Contact Form

You can show a contact form by using the [contact_form] shortcode. For information on configuring contacts, read the Contact Page guide. Note that this shortcode can be used on any page.

Video

WordPress has its own feature for embedding videos into post and page content. What Risen does is extend this feature to make the embedded videos responsive. All you need to do is encapsulate the URL of a YouTube or Vimeo page with the [embed] shortcode. Other video hosting services are supported as well. You can read the WordPress Embeds page for complete information.

Example

[embed]http://www.youtube.com/watch?v=Ck2NED-MtEM[/embed]

[embed]http://vimeo.com/25838697[/embed]

Translation

Localization

Risen has been fully localized and is translation-ready. A PO file is included in the theme's languages folder. You can use this file to translate all text in the theme into your own language. The resulting translated file is an MO file.

Translation Tools

The Codestyling Localization plugin makes translation easy and is highly recommended. There is another popular tool but it is not recommended. That tool is POEdit and its current version (as of writing) can cause problems (for more info, read this).

Installing Codestyling Localization Plugin

  1. Log into your WordPress admin and navigate to Plugins > Add New
  2. Search for "Codestyling Localization" then click Install Now next to the plugin
  3. Click Activate Plugin after installation

Making Your Translating

  1. Navigate to Tools > Localization (Codestyling Localization plugin adds this)
  2. Scroll down to Risen and click Add New Language. Choose your language then click create po-file. This makes a PO file for your language in the theme's languages directory.
  3. Now your language shows in the list by "English/United States". Click Rescan by your language then Scan Now. This adds English text from the theme to your PO file so it can then be translated into your language.
  4. Click Edit by your language and you will see lines of text in English.
  5. Now click Edit by one of those lines of text.
  6. Enter your translation for that particular text then click Save. Repeat this for every line of text.
  7. After translating every line of text, click the generate mo-file button at the top. This makes an MO file with your complete translation in the theme's languages directory.
  8. Now look at the top of the page for something like "File: languages/pt_BR.po". Write down the "pt_BR" part. Your code will be different. In this example, the language file is for Brazilian Portuguese (pt for Portuguese and BR for Brazil). You will need this code when activating your translation.

Activating Your Translation

  1. FTP into your web server and navigate to your WordPress installation's directory.
  2. Download the wp-config.php file and open it in a text editor (Notepad).
  3. Change define('WPLANG', ''); to define('WPLANG', 'pt_BR'); where pt_BR is the language code you wrote down in the last step of the "Making Your Translating" instructions above. You can also determine this code by looking into the theme's languages folder where your PO and MO files were created.
  4. Save wp-config.php then upload it to your web server.

Now view your website and WordPress admin area to make sure your translation has been applied. Note that most of the translated text appears in the admin area such as the Theme Options and areas for managing pages (sections), portfolio items, services and testimonials.

Complete WordPress Translation

What you have done translates the Risen theme, but WordPress has a bunch of text in the admin area that you will probably also want in your own language. Thankfully, many translations are already available. Using one of these translations will make the entire WordPress admin area appear in your language.

Read Installing WordPress in Your Language for a guide. Basically you will download an MO file (such as pt_BR.mo) then upload it to wp-content/languages (you may have to create the languages directory). Since you already modified wp-config.php, that's all you have to do. Keep in mind that the code you enter into wp-config.php must also match the locale for the translation you make for the theme.

Child Theme Note

You can also store your MO language file in a child theme. Read the Child Theme guide for information. The advantage of this is that if you ever update Risen and forget to save your MO file, you won't lose it (because it's kept in the child theme).

Child Theme

Custom Styles, Functionality

Read First: Most users do not need to use a child theme for appearance customizations. Read the Customization guide for information on how to upload a logo and change colors, fonts and background without having to edit code.


If you are going to modify Risen (changing styles or adding features, for example), it is strongly recommended that you use a child theme to do it. The reason this is recommended is that by making modifications using a child theme, the original (parent) theme is untouched. By keeping your modifications separate, you will be able to update the parent theme (if ever needed) without having to remake (or worse, lose) your changes. For these reasons, Risen supports child theming and includes one with examples showing how to do certain things.

Keep in mind that there is more to child theming than can be provided in this guide. You should familiarize yourself with WordPress Theme Development and read about child themes on WordPress.org.

Install Example Child Theme

The package you received has a theme folder with a risen-child.zip file in it. This is the sample child theme. You install it like you installed the parent theme (note that the parent theme must remain installed for the child to work). Go to Appearance > Themes > Install Themes > Upload to upload the zip. Be sure to activate it after installation.

The child theme will have been installed into the wp-content/themes/risen-child directory. Note that your content, menu and Theme Options will remain the same and you can uninstall the child theme at any time. However, your widgets will not carry over from your parent theme. You will either have to reconfigure them or or use the Widget Settings Importer/Exporter plugin to export them when using the parent theme then import them after switching to the child theme.

Overriding Styles

You can override specific styles with a child theme without editing the parent theme's original stylesheet. Go to wp-content/themes/risen-child and open style.css for editing. It is not necessary to @import the parent stylesheet here because it is automatically enqueued.

You can copy specific styles from the parent style.css file into the child style.css file, then change their properties. You can also add new styles here. Keep in mind that Risen's color and image related styles are not in this file but rather contained within a color scheme stylesheet. Read the next section for details.

Note that even if you don't override styles, the style.css file must exist in order for the child theme to work. The header portion of the stylesheet must also remain intact, although you can change the details.

Color Schemes

Editing a Color Scheme

You can modify the light and dark color schemes in the same way that you modify styles for the main stylesheet (read previous section). For example, you can go to risen-child/styles/light and open style.css in order to override or add styles to the light color scheme.

Adding a Color Scheme

To add your own color scheme, go to the parent theme's styles directory then copy and rename either the light or dark folder (with style.css, images and all) into the styles directory in the child theme. You will end up with something like risen-child/styles/my-new-color. Next, edit the style.css file and images that you copied in a way that makes it a completely new color scheme.

After you have created the new color scheme's directory inside of the child theme's styles directory, it will be available for selection in Theme Options. You will of course want to select your new color scheme so you can see what you are working on. If you ever switch back to the parent theme, your color scheme will not be available, because it is part of the child theme.

Overriding Files

You can override most of the parent theme files. Simply copy a file from the parent theme to the child theme. When a file exists in the child theme, that version will be used. The following files can be overridden in this manner.

  • styles/*/style.css - color schemes are covered in the section above
  • js/* - you can override any of the JavaScript files
  • *.php - any PHP file in the parent theme's root directory (index.php, functions.php, etc.)
  • *.css - any CSS file in the parent theme's root directory (style.css, for example)
  • screenshot.png - you may want to give your child theme a cover image

Note that files in the theme's includes directory cannot be overridden. Instead, specific parts of these files can be changed (there is no point in replacing a whole file when you only need to change one function). Read the next section for information.

functions.php

If you look at the parent theme's functions.php file, you will see that a lot of magic happens in there. Mainly what it does is set WordPress theme features and assign functions (from includes/*.php) to action and filter hooks. The example child theme's functions.php is setup to fire hooks after the parent theme's functions.php has set its hooks. This means you can use the child theme to remove and replace existing actions and filters.

Removing and Adding Hooks

Most of Risen's functions are assigned to hooks (either actions or filters). The example child theme's functions.php shows you how you can change these (you can also add totally new ones). For example, the parent theme sets an action that calls a risen_admin_menu function to manipulate the WordPress admin menu. You can remove that action then re-add it to use a different function such as risen_child_admin_menu in order to manipulate the admin menu in a different way.

Instead of repeating the example code here, take a look inside the child theme's functions.php file to see the real thing (it is well-commented).

Pluggable Functions

Most of the theme's functions are used by action and filter hooks and can be changed as described above. The functions that are not used by hooks are pluggable. You can tell which functions are pluggable by looking through the files in includes. If a function has this piece of code before it then it is pluggable.

if ( ! function_exists( 'function_name ' ) ) {

You override a pluggable function simply by adding a function with the same name to the bottom of the child theme's functions.php file (see for example). The child theme's function will be used in place of the parent theme's function.

Modifying Widgets

Widgets are made using classes, not functions. Every widget uses a pluggable class so you can override a widget class in the same way as overriding a function (read above).

An alternative method which is beyond the scope of this starter guide is to extend a widget class. This gives you more control such as being able to replace a specific method rather than the whole class.

Adding Stylesheets and JavaScript

The preferred way to add a stylesheet or JavaScript file with WordPress is to enqueue it (versus modifying <head> in header.php). You can do this by adding one line of code to the functions.php file. Again, look inside of the child theme's functions.php file for actual examples with code comments.

Localization

If you completed the Translation guide, your result was an MO file. You may if you wish store that file inside of the child theme for safer keeping. This way you don't risk losing it if you ever forget to back it up before updating the parent theme. You can use an MO file in the child theme in two steps.

  1. Copy the parent theme's languages directory to the child theme.
  2. Add this line to the risen_child_setup function in the example child theme's functions.php file:

    load_child_theme_textdomain( 'risen', RISEN_CHILD_DIR . '/languages' );

The second step tells WordPress that you want it to load the MO file from the child theme's languages folder.

PSD Files

Editing Graphics

Risen includes two layered Photoshop PSD files. You can find these files in the psd folder which is inside the zip file you downloaded. One file is of the light design while the second file is of the dark design. These PSD files are useful for editing graphics that the theme uses. For example, if you do not have your own logo to upload, you can change the text of the logo in one of the PSD's and use that as your logo. View assets.txt in the psd folder for a list of fonts and textures (with download links) used in the design.

File Descriptions

PHP, CSS, JS

The files listed below are in the theme folder of the package you received. Installation places the contents of risen.zip inside of your /wp-content/themes/risen directory. If you plan on making modifications, this list should help you understand what is what. It is strongly recommended you make customizations using a Child Theme (example included).

  • risen.zip - contains theme files, can be uploaded via WordPress admin in order to install theme
    • images - preset backgrounds and images not specific to a color scheme
    • includes
      • recaptcha - reCAPTCHA PHP library providing optional contact form spam protection
      • admin.php - general admin functions, theme activation
      • blog.php - blog-related functions
      • comments.php - controls the display of comments on pages/posts
      • contact-form.php - display and process contact form via AJAX, reCAPTCHA optional
      • customizations.php - colors, fonts, background, favicon, Google Analytics, social icons
      • enqueue.php - inject stylesheet calls into header.php's <head>
      • events.php - post type, meta boxes, admin columns and widget
      • files.php - functions aiding in download of MP3 and PDF files
      • gallery.php - post type, category taxonomy, meta boxes, admin columns and widget
      • helper-functions.php - various helper functions
      • home-boxes.php - post type to help with management of image boxes on homepage
      • locations.php - post type, meta boxes, admin columns and widget
      • maps.php - functions aiding in the display and configuration of Google Maps
      • media.php - custom image sizes, video embedding
      • meta-boxes.php - functions related to meta boxes
      • multimedia.php - sermon post type, taxonomies, meta boxes, widgets, date archive enablement
      • navigation.php - register header and footer menus, show breadcrumb path
      • options.php - functions relating to Options Framework plugin, default option values
      • pages.php - meta boxes, page helper functions
      • posts.php - various functions relating to posts and pages
      • shortcodes.php - register various shortcodes
      • sidebars.php - register sidebars, helper functions
      • slider.php - slider post type, meta boxes and admin columns
      • staff.php - post type, meta box, admin columns and widget
      • widgets.php - register widgets, general widgets (specific widgets are in other files)
    • js
      • admin.js - loaded in WordPress admin (when needed) to make user experience better
      • css3-mediaqueries.js - css3-mediaqueries.js makes CSS3 media queries work in old browsers
      • hoverIntent.js - hoverIntent helps Superfish dropdown menus work better
      • jquery.backstretch.min.js - Backstretch is used for full screen background images
      • jquery.easing.js - jQuery Easing helps with the smooth scrolling effect on some pages
      • jquery.flexslider-min.js - FlexSlider powers the responsive slider on the homepage
      • jquery.prettyPhoto.modified.js - prettyPhoto powers the gallery lightbox
      • jquery.smooth-scroll.min.js - jQuery Smooth Scroll makes the scrolling possible
      • jquery.validate.min.js - the Validation jQuery plugin is used on the comment form
      • main.js - the theme's main JavaScript file, heavily commented
      • modernizr.custom.js - Modernizr provides feature detection, HTML5 support for old browsers
      • selectnav.min.js - SelectNav.js makes the main menu mobile friendly
      • superfish.js - Superfish enhances the dropdown menu
      • supersubs.js - assists the Superfish dropdown menu
    • languages/en_US.po - PO file for Translation into other languages
    • mediaelement - JavaScript, CSS, images and other files for the audio player (MediaElement.js)
    • styles - light and dark base stylesheets and images
    • 404.php - "File Not Found" template
    • archive.php - year, month and day archives for blog
    • archive-risen_multimedia.php - year, month and day archives for sermons
    • attachment.php - redirects files to page/post they are attached to, when possible
    • author.php - author archive for blog posts
    • category.php - category archive for blog posts
    • comments.php - template for displaying comment form and comments on posts/pages
    • contact-form.php - template for contact form shortcode
    • footer.php - template for footer content
    • functions.php - constants, includes, feature enablement, action and filter hooks
    • header.php - template for header content
    • header-blog-archive.php - header template used for blog
    • header-gallery-archive.php - header template used for gallery
    • header-multimedia-archive.php - header template used for sermons
    • header-page.php - header template used for regular pages
    • index.php - displays homepage content
    • loop-blog.php - template for list of blog posts
    • loop-events.php - template for list of events
    • loop-gallery.php - template for list of images/videos
    • loop-home-boxes.php - template for homepage image boxes
    • loop-locations.php - template for list of locations
    • loop-multimedia.php - template for list of sermons
    • loop-slider.php - template for homepage slider items
    • loop-staff.php - template for list of staff members
    • options.php - backward compatibility with older versions of Options Framework
    • page.php - template for regular pages
    • screenshot.png - screenshot thumbnail for theme
    • search.php - blog search results template
    • searchform.php - blog search form
    • sidebar.php - primary sidebar (regular pages)
    • sidebar-blog.php - blog sidebar
    • sidebar-contact.php - contact page sidebar
    • sidebar-events.php - events sidebar
    • sidebar-gallery.php - gallery sidebar
    • sidebar-home-column-left.php - widget area for bottom-left of homepage
    • sidebar-home-column-right.php - widget area for bottom-right of homepage
    • sidebar-locations.php - locations sidebar
    • sidebar-multimedia.php - sermons sidebar
    • sidebar-staff.php - staff page sidebar
    • single.php - display single blog post
    • single-risen_event.php - display single event
    • single-risen_gallery.php - display single gallery image or video
    • single-risen_home_image_box.php - redirect home box item permalink to homepage
    • single-risen_location.php - redirect location permalink to page using locations template
    • single-risen_multimedia.php - display single sermon
    • single-risen_slide.php - redirect slider item permalink to homepage
    • single-risen_staff.php - redirect staff member permalink to page using staff template
    • style.css - main stylesheet, contains theme info in header (also see styles directory)
    • style-admin.css - stylesheet loaded in admin area
    • style-editor.css - stylesheet loaded by WYSIWYG editor in admin
    • taxonomy-risen_gallery_category.php - gallery category archive
    • taxonomy-risen_multimedia_category.php - sermon category archive
    • taxonomy-risen_multimedia_speaker.php - sermon speaker archive
    • taxonomy-risen_multimedia_tag.php - sermon tag archive
    • tpl-blog.php - page template for blog index (newest first)
    • tpl-contact.php - page template for contact page
    • tpl-events.php - page template for events
    • tpl-gallery-all.php - page template for showing all gallery items
    • tpl-gallery-categories.php - page template for showing gallery categories
    • tpl-gallery-images.php - page template for showing gallery images (no videos)
    • tpl-gallery-videos.php - page template for showing gallery videos (no images)
    • tpl-locations.php - page template for locations
    • tpl-multimedia.php - page template for sermon archive
    • tpl-staff.php - page template for staff
  • risen-child.zip - optional child theme example for making customizations
  • sample-data.xml - importable pages, posts and menu to make your install like the Risen Live Preview
  • sample-widgets.json - importable widget content to make your install like Live Preview

Recommendations

Plugins, Hosting

Here are some resources that might help you with your site.

Plugins

There are some things that are better off left to plugins. Here are a few plugins that I recommend.

Search Engine Optimization

I recommend Yoast SEO for search engine optimization tweaking. It is regarded as one of the best SEO plugins (the best in my opinion) and works well with Risen. And it's free.

Social Bookmarking

I found AddThis to look nice and work well with Risen when configured a certain way. This plugin can add social bookmarking buttons for Twitter, Facebook, etc. to your posts, sermons, etc.

After installing and activating it, I recommend you go to Settings > AddThis and configure it in these ways.

  • In Basic cause it not to show below posts (only above).
  • In Advanced uncheck the excerpts box under Show AddThis on...

Translation

The Codestyling Localization plugin is the best translation tool I have used. Read the Translation guide for complete instructions on using it with this theme.

Hosting

These are my suggestions if you need hosting for your WordPress site. They are not the cheapest but they have good reputations and for me that is more important than cheap.

  • Media Temple - I have used them for several years have been very satisfied.
  • WP Engine - Managed WordPress hosting that I haven't tried but probably will based on what I have heard.

I will receive a commission if you sign up after clicking either of these links.

Frequently Asked Questions

Common Solutions

There are some questions that come up more than others. If you have a question, it may be answered here. If not, please submit a Support request.

  1. "The package could not be installed. The theme is missing the style.css stylesheet."

    The zip file you downloaded is not the actual theme zip for installing to WordPress. It contains documentation, PSD files, license files, the actual theme zip and some sample content. Unzip this file on your computer first then you will find the actual theme zip file at theme/risen.zip. On most computers you can simply right-click on a zip file then choose something like "Extract". Watch the Installation Video for a demonstration.

  2. How can I disable comments on pages or posts?

    You can disable comments on a per page/post basis and globally. To disable comments globally, go to Settings > Discussion and uncheck the box for "Allow people to post comments on new articles". This only applies to new posts.

    For pages/posts that you already created, you will need to disable comments manually for each. Go to edit one of your pages or posts and look for Screen Options at the top-right. Click it then make sure the "Discussion" option is checked. It causes a "Discussions" box to appear at the bottom of the page below the content editor. Uncheck the "Allow comments" option in this box then save your post/page.

  3. The images I uploaded are appearing too big. Why?

    If an image you provided for the slider, page header or other area is appearing larger than expected, make sure it is at least the recommended size. The recommended size for slider images is 960x350 and 960x250 for page header images. You can find other recommended sizes in your WordPress admin area by the "Set featured image" link and in this documentation.

    WordPress will not resize/crop an image that is less than the target size, so when an image that is too small is provided the browser scales it up to fill the width. The result is often a pixelated image with too much height.

  4. "Page Not Found" or "File Not Found" when trying to access some pages.

    Your permalink structure (friendly URL's) is not active. Please repeat Step 3 in Installation:

    1. Go to Settings > Permalinks.
    2. Choose your preferred URL format ("Day and name" recommended — don't use "Default").
    3. Save even if you are sticking with what is already set.

    If you do this but the problem persists, your server may not be allowing WordPress to write the .htaccess file which enables a friendly URL structure. Return to Settings > Permalinks and look for manual instructions provided by WordPress below the Save button.

  5. Why are e-mails sent by the contact form are not being received?

    Here are some things to try:

    1. Wait a few minutes and check your spam folder. E-mail are sometimes delayed or marked as spam.
    2. Verify that the contacts in Appearance > Theme Options > Contact are using the correct format.
    3. Deactivate all plugins in case there is a conflict.
    4. Try using a "To" e-mail address that has your website's domain in it (you@yoursite.com).
    5. Ask your host (or check their knowledgebase) if there is anything special that needs to be done to get PHP's mail() function working.
  6. How should I set my site live by moving it from its development location to its final location?

    It is common to prepare a WordPress site at yourname.com/dev (or similar) then move it to yourname.com, so that the old site remains online while the new site is being made. After your site is done, you can move it to the final location by following "On Your Existing Server" in the When Your Domain Name or URLs Change article at WordPress.org. Be sure to backup both the new and old sites before you start.

Support

I'm Here to Help

If you have a question that is not answered in this documentation or the FAQ or if you discover a problem, you can submit a support request via the form on my Profile Page (must be logged in to see form) and I will respond by e-mail. Please provide a URL to your website if there is a problem for me to see. My goal is to answer questions within 24 hours on weekdays (excluding US holidays and the rare period of travel).

Please Note: Support is limited to questions regarding the theme's features or problems with the theme. I am not able to provide support for code customizations or third-party plugins.

Please Rate Risen

Ratings & Testimonials

I hope you are finding Risen to be a good solution. If that's the case, please share your experience with others by rating it or by providing a testimonial. Also know that if you have encountered a problem or need some help, you can Ask for Support. It's my pleasure to help my customers.

Rate It on ThemeForest

You can give Risen a rating up to five stars by logging into ThemeForest then going to the Downloads area in your account. Thank you for doing this.

Write a Testimonial

I like to share what others have said about my themes by posting their testimonials on ThemeForest. If you would like to submit one, please use the contact form on my Profile Page (must be logged in to see form). Here's an example testimonial.

"Risen is exactly what we were looking for and has been very easy to use. Our new church website is online and looks great! We highly recommend this theme." — Ronnie Jones

Sources & Credits

Thank You

Appreciation is given to the people behind these helpful projects and resources.

WordPress & PHP

JavaScript & CSS

Fonts & Images

Preview Materials

These items are only used in the theme's live preview and are not included with the theme.

Changelog

Improvements

See the Updating section for instructions on updating to the latest version.

v1.1.6 (December 10, 2012)

  • Adjusted option field widths to work best with latest Options Framework.
  • Made search results page heading translatable.
  • Added clearfix for post content so image floats don't overflow.
  • Enabled lightbox support for Vimeo URL's using https.
  • Minor change to sample content images.
  • Improved implementation of flush_rewrite_rules() on theme activation.
  • Improved documentation (adjusted for WordPress 3.5 interface).

Files Modified:

  • includes/admin.php
  • includes/options.php
  • js/jquery.prettyPhoto.modified.js
  • options.php
  • search.php
  • style.css

v1.1.5 (November 19, 2012)

  • Removed "Related Videos" from end of playback of YouTube video in gallery lightbox.
  • Set neutral coloring on lightbox videos from YouTube and Vimeo.
  • Made "no events" text in widget apply generally to upcoming and past events.
  • Replaced admin_print_styles with admin_enqueue_scripts in functions.php.
  • Corrected support for skype:username URL for social icons.

Files Modified:

  • includes/customizations.php
  • includes/events.php
  • js/jquery.prettyPhoto.modified.js
  • functions.php

v1.1.4 (November 12, 2012)

  • Added search results for multiple post types
  • Added search sidebar
  • Corrected textdomain on Not Found page
  • Enabled skype://username for social icons (update: this is incorrect in fixed in next release)
  • Cleaned up map commenting
  • Improved documentation

Files Modified:

  • includes/customizations.php
  • includes/maps.php
  • includes/sidebars.php
  • languages/en_US.po
  • styles/dark/style.css
  • styles/light/style.css
  • 404.php
  • loop-blog.php
  • loop-event.php
  • loop-multimedia.php
  • loop-search.php
  • search.php
  • short.php
  • short-event.php
  • short-gallery.php
  • short-multimedia.php
  • short-staff.php
  • sidebar-search.php
  • style.css

v1.1.3 (October 2, 2012)

  • Added theme option for Google Web Font character sets.
  • Added help note visible only to admin on "Not Found" page.
  • Fixed issue with multimedia's "Play Video" button when there is no audio option.
  • Improved handling of multimedia file downloads.
  • Sample content (XML) improvements.
  • Localized sample content import notice shown after activation.
  • Improved theme update security (to prevent this).
  • Enabled static front page support.
  • Corrected translation context for events widget "Upcoming" and "Past" options.
  • Provided more specific text for previous and next buttons (e.g. "Older Sermons" instead of "Older Items").
  • Documentation improvements.

Files Modified:

  • includes/admin.php
  • includes/enqueue.php
  • includes/events.php
  • includes/multimedia.php
  • includes/navigation.php
  • includes/options.php
  • includes/posts.php
  • includes/widgets.php
  • js/admin.js
  • js/main.js
  • languages/en_US.po
  • 404.php
  • archive.php
  • archive-risen_multimedia.php
  • author.php
  • category.php
  • files.php
  • functions.php
  • loop-multimedia.php
  • search.php
  • single.php
  • single-risen_event.php
  • single-risen_gallery.php
  • single-risen_multimedia.php
  • style-admin.css
  • tag.php
  • taxonomy-risen_gallery_category.php
  • taxonomy-risen_multimedia_category.php
  • taxonomy-risen_multimedia_speaker.php
  • taxonomy-risen_multimedia_tag.php
  • tpl-blog.php
  • tpl-events.php
  • tpl-events-past.php
  • tpl-gallery-all.php
  • tpl-gallery-images.php
  • tpl-gallery-videos.php
  • tpl-locations.php
  • tpl-multimedia.php
  • tpl-staff.php

v1.1.2 (September 21, 2012)

  • Improved handling of shortcode content filtering for better compatability with plugins.
  • Added function namespacing in several missing instances.
  • Updated default footer copyright content.
  • Fixed top-right tagline in old versons of Firefox
  • Improved various featured image size notes in admin area.
  • Updated jQuery Smooth Scroll to fix issue with Safari 6 on Mountain Lion and iOS.
  • Improved dropdown menu activation.
  • Enabled superscript (<sup> tag).
  • Fixed Google Maps issue with older versions of Android browser.

Files Modified:

  • js/jquery.smooth-scroll.min.js
  • includes/enqueue.php
  • includes/gallery.php
  • includes/home-boxes.php
  • functions.php
  • header.php
  • main.js
  • shortcodes.php
  • style.css

v1.1.1 (August 20, 2012)

  • Added "No left padding" option for logo upload.
  • Fixed issue with video or audio icon showing beneath player when only one media type available.
  • Prefixed all icon-* classes to prevent conflict with All-in-One Event Calendar plugin.
  • Added size note below Staff feature image.
  • Documentation improvements.

Files Modified:

  • styles/dark.css
  • styles/light.css
  • includes/customization.php
  • includes/multimedia.php
  • includes/options.php
  • includes/shortcodes.php
  • includes/staff.php
  • functions.php
  • header.php
  • loop-blog.php
  • loop-events.php
  • loop-multimedia.php
  • main.js
  • single.php
  • single-risen_event.php
  • single-risen_gallery.php
  • single-risen_multimedia.php
  • style.css

v1.1.0 (August 14, 2012)

  • Split Events into two templates: Upcoming Events (improved sorting) and Past Events.
  • Made events widget capable of showing upcoming or past events.
  • Added new Shortcodes (buttons, columns, tabs, accordion, quote and boxes).
  • Made WordPress Embeds (videos) responsive.
  • Logo is now linked to homepage.
  • Added Tumblr and Pinterest social icons.
  • Added option for generic address icon in footer for non-church websites.
  • Homepage bottom widget column left or right expands to full width if only one used.
  • Improved margin of headings in page/post content.
  • Fixed issue with PDF not showing on single multimedia post when no other formats provided.
  • Fixed RSS widget heading when used on homepage.
  • Improved padding of text in widgets and labels.
  • Improved translatability of "# days ago" text string.
  • Improved rewrite rule flushing on theme activation.
  • Documentation expansion and improvements.

Files Modified:

  • js/main.js
  • css/style.js
  • styles/light/style.css
  • styles/light/image/footer-icon-sprites.png
  • styles/dark/style.css
  • styles/dark/image/footer-icon-sprites.png
  • includes/admin.php
  • includes/contact-form.php
  • includes/customization.php
  • includes/events.php
  • includes/loop-events.php
  • includes/maps.php
  • includes/media.php
  • includes/options.php
  • includes/posts.php
  • includes/shortcodes.php
  • languages/en_US.po
  • contact-form.php
  • footer.php
  • functions.php
  • loop-events.php
  • index.php
  • single-risen_multimedia.php
  • single-risen_event.php
  • tpl-events.php

Files Added:

  • styles/light/images/accordion-arrow-down.png
  • styles/light/images/accordion-arrow-right.png
  • styles/light/images/icon-alert.png
  • styles/light/images/icon-check.png
  • styles/light/images/icon-down.png
  • styles/light/images/icon-info.png
  • styles/light/images/icon-x.png
  • styles/dark/images/accordion-arrow-down.png
  • styles/dark/images/accordion-arrow-right.png
  • styles/dark/images/icon-alert.png
  • styles/dark/images/icon-check.png
  • styles/dark/images/icon-down.png
  • styles/dark/images/icon-info.png
  • styles/dark/images/icon-x.png
  • tpl-events-past.php

v1.0.4 (July 19, 2012)

  • Fixed JavaScript error in Firefox 8 relating to selectNav.js.
  • Made widget classes pluggable via child theme.
  • Documentation improvements.

Files Modified: js/main.js, includes/widgets.php, includes/blog.php, includes/events.php, includes/gallery.php, includes/locations.php, includes/multimedia.php, includes/staff.php

v1.0.3 (July 12, 2012)

  • Added 12 videos and made improvements to documentation.
  • Fixed issue with slider when using only one slide that has a video.
  • Made improvements to notes in Theme Options.

Files Modified: js/main.js, includes/options.php

v1.0.2 (July 9, 2012)

  • Corrected "Both DOS and UNIX style line endings were found..." Theme Check warning.

Files Modified: includes/options.php, includes/maps.php

v1.0.1 (July 9, 2012)

  • Improved spacing on homepage widgets

Files Modified: style.css

v1.0 (July 5, 2012)

  • First release