Beruflich Dokumente
Kultur Dokumente
PHOTOEVENTFUL
PREMIUM EVENTS WORDPRESS THEME
Documentation
WWW.WPEVENTFUL.COM
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
2
FEATURES.............................................................................................................................................................................. 3 YOUR FIRST EVENT ........................................................................................................................................................... 5 INSTALLATION .................................................................................................................................................................... 4
CONTENTS
YOUR FIRST LOCATION ................................................................................................................................................. 12 YOUR FIRST PORTFOLIO ITEM................................................................................................................................... 15 DWS CONFIGURATION PANEL ................................................................................................................................... 17
SLIDER OPTIONS.......................................................................................................................................................... 28
DEVELOPERS ...................................................................................................................................................................... 40
COPYRIGHT INFORMATION......................................................................................................................................... 44
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
3
FEATURES
EVENTS
Simple event Event Duration Upcoming Events
Featured Events
ARTISTS
Artists Featured Artists Artists Multiple Roles
LOCATIONS
Locations Featured Locations Google Maps
OTHER FEATURES
Multiple Layouts Custom Shortcodes & Widget Responsive Design
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
4
INSTALLATION
created using the wpEventful Platform, an advanced Events Manager System. In order to correctly Dashboard. In the left-hand menu go to Appearance > Themes and click on the Install Themes tab un-zipping the archive you downloaded upon purchase. Find the photoeventful.zip file, select it and press the Open button; then click on the Install Now button and wait for the theme to upload and install. install this product, please start with a new WordPress install and then access your administration then click on upload link, bellow. Browse to the PhotoEventful Folder you previously created by Thank you for purchasing PhotoEventful Theme. This Premium WordPress Theme was
activate it. Once you did that go to Appearance > wpEventful and start configuring accordingly to your need. Make sure you filled the information under Contact tab because it contains mandatory be altered later if you choose to do so.
Once you uploaded and correctly install PhotoEventful Theme you will have the option to
fields and select your desired style under Appearance tab. All information provided at this time can
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
5
YOUR FIRST EVENT
After you correctly installed your copy of the theme it is time to set up your first event. In you can see a step by step guide how to create your first event. order to do so, you must go to WordPress Dashboard and on the left side menu click on Events > Add Event. As soon as the page is loaded you can start filling the fields. Bellow
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
6
STEP 2 EVENT DESCRIPTION
Enter a description using the default WordPress editor and/or the available Shortcodes. In PhotoEventful we incorporated a bundle of layout Shortcodes and specific codes for each the Shortcodes chapter of this documentation. custom post type such as: Events, Artists and Locations. For more on this topic please see
After you entered the content it is time to direct your attention to the Events Meta Box.
wpEventful platform allows you to create a diversity of events. We will present to you To start you must press +Add New Representation link. This will add an event details box Facebook Button that allows you to quickly share the event with your followers and friends. every option available so you can understand which is best suited for your specific needs. with the following fields: Start Date / End Date / Duration / Ticket Price / Location and a
Not only you will be able to create very complex events oriented websites but you will do
DOCUMENTATION
7
There are two ways to create artists for your events. The first one is to simply go to Events Meta Box and click on Artists tab. This will display a list of categories/roles for your artists and an input field. Add your artists name into the input box and click on the plus button on the right. If your artist is already created it will at a time. You dont need to worry about roles at this moment as you can modify this after WordPress Administration, accessible from the left side menu. appear on the auto-suggest box bellow the input area. Since this is your first event we can assume there are no artists created previously. Add as many artists as you need, one name you publish your event. Also, when you publish your event, the new artists will be automatically created for your and you can modify them from the Artists section in The second method to create your artists is by going to WordPress Dashboard and click on Artists > Add Artist in the left hand menu. This will take you to a new page where you categories that will act as roles, and configure many other features. first artist section of this documentation. can add the name of your artist in the title field, a description, featured image, set up the For a detailed step-by-step guide on how to create and modify your Artists please see Your
When you have a list of events you may wish to promote some of them. We wanted to offer called Featured. If you activate this option your event will automatically be displayed on front page slider and the thumbnails will have a small ribbon with the text Feat..
you the possibility to highlight certain events so we added in the Events Meta box a section
One of the default features of WordPress is ability to organize your content in categories. Events custom post-type in wpEventful gives you the possibility to group your events in
DOCUMENTATION
8
multiple categories. Also, if you need a new category, you can create one directly from the Edit Event page.
does such a good job to resize images we would only want to recommend you not to use
PROFESSIONAL ADD-ON
If you need more flexibility with your events we recommend you to check the Professional Add-on available for purchase on our official website: www.wpeventful.com . This product is a plug-in that will add recurrent events, multiple events, location and organizer repertories, multiple locations per event, usability Shortcodes, individual SEO options for each page/post, additional widgets and so much more to your PhotoEventful theme.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
9
YOUR FIRST ARTIST
One of the key aspects of wpEventful platform is that it allows you add artists/people to your events. If you wish to create events such as conferences, concerts, shows, movies, galleries, theater plays, trainings, etc. you will need to add those persons that make your event interesting and appealing to the audience. No matter what kind of people your event involves, you can add them in a dynamic way with wpEventful platform. You can assign roles by creating specific categories for each artist, date of birth, gender and website. Also, in Add New Artist page. you can highlight certain artists from your database by using the featured options available In the section Your First Event, you discovered how easy it is to create a new artist directly that will permit you to take advantage of all the features available for the Artists custom post type. You will need to start from the left side menu in you WordPress Dashboard by clicking on follow the next steps:
from Add New Event page and now we will present to you a second, more in-depth method
Artists > Add Artist link. This will open the Add New Artist page and all you have to do is
Next you can add a description of your artist using either the default WordPress formatting the Artists custom post-type, please see the Shortcodes section of this documentation.
tools or by taking advantage of the powerful Shortcodes you will discover in the Shortcodes
Meta box. To find out more about the Layout Shortcodes and those created especially for
DOCUMENTATION
10
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
11
Step 4 Artist Categories
roles to your artists. For example, if you wish to add a list of people involved into a theater play, you will need to differentiate actors from extras, directors, producers, musicians or event you will be able to select a specific role or multiple roles. Lets take the above example and go forward and say that you have two theater plays; the ARTIST X is a director dancers. All you have to do is to create categories for each occupation and allocate each artist to his/her specific category. You can allocate multiple roles to each artist and in every in PLAY 1. In PLAY 2, ARTIST X is the director and one of the actors. wpEventful will display both categories to the artist page (director and actor) but for each event will display only the allocated role. Also, if you need a new category, you can create one directly Categories. from the Add/Edit Artist page or go into the left hand menu and click on Artist > Artist Categories in Artists custom post-type were designed to give you the possibility to add
PROFESSIONAL ADD-ON
If you need more flexibility with your events we recommend you to check the Professional Add-on available for purchase on our official website: www.wpeventful.com . This product is a plug-in that will add recurrent events, multiple events, location and organizer repertories, multiple locations per event, usability Shortcodes, individual SEO options for each page/post, additional widgets and so much more to your PhotoEventful theme.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
12
YOUR FIRST LOCATION
Location is an important feature of wpEventful because it gives your visitors important information about the place where an event will take place. Using our platform you will be spaces/rooms/halls that might be available. able to add a unique location to every representation of your events, group your places into categories and even define parent locations to facilitate the display of the different You will need to start from the left side menu in you WordPress Dashboard by clicking on to do is follow the next steps:
Locations > Add Location link. This will open the Add New Location page and all you have
Next you can add a description of your location using either the default WordPress formatting tools or by taking advantage of the powerful Shortcodes you will discover in the Shortcodes Meta box. To find out more about the Layout Shortcodes and those created documentation. especially for the Location custom post-type, please see the Shortcodes section of this
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
13
DOCUMENTATION
14
Step 4 Location Categories
You can group your locations into categories using the default WordPress functionality. page or go into the left hand menu and click on Locations > Location Categories. Also, if you need a new category, you can create one directly from the Add/Edit Location
Here you can add the current location to a parent venue. This will allow you to display
Featured Image Meta box is a default WordPress option. If you do not upload an image to your artist, wpEventful will usually add a default "no-image" picture. Since WordPress images bigger than 1400px width or to check the file upload limit on your server. does such a good job to resize images we would only want to recommend you not to use
PROFESSIONAL ADD-ON
If you need more flexibility with your events we recommend you to check the Professional Add-on available for purchase on our official website: www.wpeventful.com . This product is a plug-in that will add recurrent events, multiple events, location and organizer repertories, multiple locations per event, usability Shortcodes, individual SEO options for each page/post, additional widgets and so much more to your PhotoEventful theme.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
15
YOUR FIRST PORTFOLIO ITEM
With wpEventful you can choose to create portfolios as independent custom posts without allows you to use the theme for presentation purposes only. using the events management structure. This adds more flexibility to your website and
Next you can add a description of your portfolio item using either the default WordPress
formatting tools or by taking advantage of the powerful Shortcodes you will discover in the Shortcodes Meta box. To find out more about the Layout Shortcodes and those created documentation. especially for the Portfolio custom post-type, please see the Shortcodes section of this
General tab: You can add a website URL, clients name and the date of completion for this Featured tab: Highlights this portfolio item on the front end of your website.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
16
Step 4 SEO Meta Box
wpEventful platform offers you the possibility to customize a bundle of aspects of your items on search engines, we added the SEO Meta box where you can modify the default options will increase the relevance of every event and add more juice to your content. website through different techniques. In order to increase the visibility of your portfolio description and add specific keywords. Every keyword must be comma separated. These
You can group your portfolio items into categories using the default WordPress Also, if you need a new category, you can create one directly from the Add/Edit Portfolio page or go into the left hand menu and click on Portfolios > Portfolios Categories.
Featured Image Meta box is a default WordPress option. If you do not upload an image to your artist, wpEventful will usually add a default "no-image" picture. Since WordPress images bigger than 1400px width or to check the file upload limit on your server. does such a good job to resize images we would only want to recommend you not to use
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
17
DWS CONFIGURATION PANEL
All premium themes come with advanced options to customize various aspects of your WordPress website. We took this in consideration and we created our own configuration platform that will you website. enable you to change colors, fonts, layouts, custom texts, and so much more. As you will see in the following chapters DWS Configuration Panel offers you endless possibilities to format and design
General Settings
YOUR LOGO / LOGO TYPE / LOGO HTML
website in an html format.
must also upload a .png transparent file. Logo HTML option will display the title of your
These options allow you to choose between html or image logo. If you select Your Logo you
CUSTOM TEXT
CONTACT INFO
website. If you leave this field empty, the box will not be shown.
In this text area you can add a custom html that will be displayed in a special box on your
Insert your email, phone number and address. This information will be displayed on your front-end site so use only public information.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
18
COPYRIGHT
COPYRIGHT INFO Insert your custom copyright text. This field will display html code in the footer bar before Developer Link information. DEVELOPER LINK
Insert your developer website or any information about the customization of your theme. This field will display html code in the footer bar next to copyright information.
MISC. OPTIONS
If you click to activate this option, you will be able to display the advertising code you have ADVERTISING CODE inserted in the field below - Advertising Code.
Here you can insert a wide variety of advertising codes, from simple banner links to AdSense code in order to monetize your website. ANALYTICS CODE We recommend you to use responsive code to display your ads.
This will be used in the header to help you track your visitors. By default, out themes have a 404 error message. Using this field will allow you to change the text/html code you will display to your visitors on error pages. 404 - PAGE NOT FOUND CUSTOM TEXT
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
19
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
20
Appearance
This menu allows you to customize the colors, fonts, links and backgrounds across your website. These are generic features that will affect your entire website.
We created a couple of pre-defined themes that can be altered using the options bellow.
PRIMARY FONT
This option is used to set the font of your entire website. SECONDARY FONT This option is used to set the font used for titles, menus and headings across your website.
COLORS
BACKGROUND COLOR:
PRIMARY COLOR
Here you can set the color of the background for the content area of your website.
The primary color is the color of the text content. SECONDARY COLOR THIRD COLOR LINES COLOR Secondary color is used to set contrast elements through-out the theme. This option allows you to add more color diversity to your text content. Lines Color allows you control the color of borders, lines and other spacers.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
21
CUSTOM CSS
This text area field will allow you to create custom CSS in order to further customize your theme. Just find the class you want to modify and enter de adequate CSS to change the style. We modifications. recommend you to use this method for altering CSS code rather than modifying the style files. This way you will be able to update your theme to the latest version without over writing your custom
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
22
Layouts
With DWS Configuration Panel was created to give you maximum flexibility and it allows you to modify the layout of each section of your website as following: HOMEPAGE / EVENTS / ARTISTS / LOCATIONS / PORTFOLIO / BLOG / PAGES
HOMEPAGE
Classic layout with multiple columns for each custom post type
Slider layout that shows only the featured events on your homepage in a carousel
Each custom post type allows you to define a unique background as following: 1. Full screen image Upload an image in Vegas Slider Images section and the theme will display stretch it on full screen. For more customization of jQuery Vegas background slider, please see chapter Slider Options of this documentation. 2. Full screen slider If you wish to display a slider on the background of your page just click on Add More Images link in Vegas Slider Images section and upload multiple images. By doing so, the theme will automatically add a jQuery Vegas slider on your front end page. of this documentation. For more customization of jQuery Vegas background slider, please see chapter Slider Options
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
23
3. Textured background If you wish to use a textured background or a pattern image upload an image using Texture image upload form then select the Repeat texture attribute that is more adequate to your need.
4. Solid color background Sometimes less is more so we added a solid color option in case you dont want an image, a slider or a texture as your page background. In order to correctly display your desired background, please make sure that the other Slider Images section by clicking the Remove Image link.
fields are empty. For example if you wish a textured background remove any images Vegas
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
24
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
25
EVENTS / ARTISTS / LOCATIONS / PORTFOLIO / BLOG / PAGES
to allow you the ability to set completely different layouts or use the same layout for each page. The choice is yours. Select Archive and Taxonomy Pages Layout will permit you to set the general layout of the All these custom post types have the same layout options that can be configured differently in order
archive and taxonomy pages of each custom post type using three options: no sidebar, with the of variations through-out the theme in order to create a unique look for your website.
sidebar aligned on the left or with the sidebar aligned on the right. Depending on what option you
select there will be up to 7 different subsidiary layouts to choose from. This will give you hundreds Also, using the Select Archive and Taxonomy Pages Top Post options you can add a slider to the
Select Single Layout option will allow you to choose between three layout options for your single custom posts: no sidebar, with the sidebar aligned on the left or with the sidebar aligned on the right.
top of your every archive / taxonomy page. These sliders will display only featured posts.
For more information about the layout of single posts pages please see the Layout Sortcodes chapter of this documentation.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
26
Each custom post type allows you to define a unique background as following: 1. Full screen image Upload an image in Vegas Slider Images section and the theme will display stretch it on full For more customization of jQuery Vegas background slider, please see chapter Slider Options of this documentation. 2. Full screen slider If you wish to display a slider on the background of your page just click on Add More Images link in Vegas Slider Images section and upload multiple images. By doing so, the theme will automatically add a jQuery Vegas slider on your front end page. of this documentation. 3. Textured background If you wish to use a textured background or a pattern image upload an image using Texture image upload form then select the Repeat texture attribute that is more adequate to your 4. Solid color background Sometimes less is more so we added a solid color option in case you dont want an image, a slider or a texture as your page background. In order to correctly display your desired background, please make sure that the other Slider Images section by clicking the Remove Image link. need. For more customization of jQuery Vegas background slider, please see chapter Slider Options screen.
fields are empty. For example if you wish a textured background remove any images Vegas
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
27
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
28
Slider options
This section of DWS Configuration Panel allows you to tweak different aspects of the sliders uses the Flexslider by WooThemes. available on you theme. The Background Slider uses jQuery Vegas plug-in and the Top Post Slider For more information please see the Copyright chapter of this documentation.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
29
Social Networks
website that are linked to your Social Accounts. DWS Configuration Panel allows you to display six social network icons on the front end of your
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
30
Contact
form. These are mandatory fields. Email and Subject information provided here will be used to send emails to you from the Contact
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
31
SEO & Languages
These days a good website is all about the SEO tools and the possibilities you have to create unique content targeting your market and your audience in an efficient way. In DWS Configuration Panel you are able to customize the slugs (that will create your custom URLs) and set specific description and keywords for each custom post type. Using these features along with the SEO options available for each post you will be able to customize every page of your website accordingly to your specific needs in terms of Search Engine Optimization and content. Another feature under this tab is the read the chapter Localization of this documentation.
option to select the Site Language. To find out more about how you can add more languages, please
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
32
LOCALIZATION
Although WordPress displays in U.S. English by default, the software has the built-in capability to be used in any language. All our themes allow you to add a translation using Localization feature. So, if you wish to add other languages just create the appropriate language file with software like POEdit. After translation just upload .MO and .PO files to /language/ directory of your theme.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
33
SHORTCODES
wpEventful platform offers you the possibility to easily customize both the layout of your content and the information you can display for your visitors using Layout Shortcodes. Meta box. All Shortcodes can be easily inserted in your WordPress editor through the Shortcodes
Layout Shortcodes
SHORTCODE
ACCORDIONS
SHORTCODE DESCRIPTION
You can easily create accordions in a multitude of styles and sizes. Using the Accordions Shortcode you can create specification lists, FAQs or any other content that needs interactive lists. With block quotes and boxes you can redirect viewers attention to certain content areas. You have the ability to select between three types of block quotes and four special boxes. Using these Shortcodes with columns options you can create hundreds of layout variations.
COLUMNS
DROPCAPS
With columns Shortcodes you can create a unique layout for each page. You can use these Shortcodes in order to format any kind of content: text, images, lists, tables, videos, etc. You can combine these in a bunch of possibilities. Bellow you can see simple text column in action: You can use these six Dropcaps Shortcodes to lead your viewers, usually, into a paragraph. Using headers you can style in a canonical way your content and attract viewers attention to important sections of your pages. You can use H1 H6 heading in various contexts.
HEADINGS
HIGHLIGHTS
If you need to attract viewers eyes on a specific area of text, you can use Highlights Shortcode. You can set four different kinds of highlights w/o colored background.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
34
IMAGE EFFECTS LISTS Using Images Shortcode you can apply four kinds of effects on your images. Using these features you will improve the design of your webpage. Your copy of the theme offers you eight different list styles: Simple Arrow, Black Arrows, Stars, Pluses, Horizontal Bars, Dots, Down Arrows and Checks. Using columns Shortcodes you can group lists by length, combine them with other content such as images, text and/or video. Bellow you can see simple lists in action.
MISCELLANEOUS - TEASER
SLIDESHOW
Miscellaneous Teaser Shortcode adds a special paragraph. This is ideal for highlighting a catch phrase or a glimpse of your article. It is best to use this option at the beginning of your post. Another great way to display Image content on your page, beside galleries, is a slideshow. Slideshows are also extremely flexible letting you customize options such as speeds, animations and opacity.
SPACERS
TABLES
In order delimitate content through-out the page, you can select between two options: Horizontal Line Spacer and Div Spacer. The first option adds a horizontal line inside you content area and the second option gives you more space between paragraphs, when used. You can choose between three table styles when you need to present various data such as reports, statistics or any other kind of content. Just insert your table inside of the appropriate Shortcodes in order to style your tables.
These Shortcodes can be used in many variations and combinations accordingly to your simply have to select the required option and you will be guided step by step. meta-box called Shortcodes available in Posts, Pages, Events, Locations, Artists, etc. You
needs and expectations. In order to take advantage of these new features we added a new
We advise you to insert your Shortcodes using the method described above in order to
avoid scripts related errors. Also, it is best that you have a basic understanding of HTML.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
35
PROFESSIONAL ADD-ON
If you need more flexibility with your events we recommend you to check the Professional Add-on available for purchase on our official website: www.wpeventful.com . This product is a plug-in that will add recurrent events, multiple events, location and organizer repertories, multiple locations per event, usability Shortcodes, individual SEO options for each page/post, additional widgets and so much more to your PhotoEventful theme.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
36
SIDEBARS & WIDGETS
Sidebars
Events Sidebar - can be found in Events Custom Post Type related pages such as Events Artists Sidebar - can be found in Artists Custom Post Type related pages such as Artists Archives, Artists Categories and Single Artist. Locations Sidebar - can be found in Locations Custom Post Type related pages such as Archives, Events Categories and Single Event.
Portfolios Archives, Portfolios Categories and Single Portfolios. Blog Sidebar - is used in blog sections and default pages.
Portfolios Sidebar - can be found in Portfolios Custom Post Type related pages such as
Widgets
DWS Custom Categories - you can select the custom post type you need to create a categories list (Events/Locations/Artists/Portfolios). This widget can be used in all sidebars. DWS Details this widget displays the custom information for custom post types. It works page. The details displayed by this widget are:
only for the all the theme custom post types and it is only being displayed in the single
DOCUMENTATION
37
Artists: the artist day of birth, the artist gender, the artist website location map Locations: location phone number, location website, location ticket office schedule, Portfolios: portfolio website, portfolio client, portfolio completion date
DWS Display Advertising - displays advertising from the code inserted in Eventful Options page. DWS Events Representations A slider with the future event representation for the event loaded in the single page. This widget works in the events, artists, locations single pages. description. DWS Featured Artist - displays the latest featured artist with picture, title and short
DWS Featured Image - displays the featured image, if available, on any single post type. was set in the widget settings. This widget can be displayed in all sidebars. only be used in the locations single page.
sidebars. The list contains Event's image, title and the date of the event.
DWS Featured Events - its a list of the latest Upcoming Events that can be displayed in all
DWS Featured Location - displays a list of featured locations depending on the count that DWS Location Sub-locations displays the list of all the sub locations of a location. It can
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
38
MENUS & NAVIGATION
Eventful - Events Premium WordPress Theme - comes with a couple of modifications to the original WordPress menu system in order to facilitate the use of features such as Events, Artists and Locations (Custom Posts Type). See image below:
In order to customize your website's main menu you must go to administration, left-hand
menu, click on Appearance > Menus. In order to insert into your menu the main features (Events/Locations/Artists) you must go to Custom Post Types box and click on all options
DOCUMENTATION
39
(Locations/Events/Artists/Portfolios). When you are finished press the "Add to menu" button and the selected custom post types will be added to your menu (right panel). To add sub-navigation to your custom post types just go to Location Categories, Event Categories, Artist Categories, Portfolios Categories and click on the categories you want to are finished just press on Save Menu button and go to your website and check the new menu. Another thing you should be aware is that in our themes Default Posts are used as Blog Items. So, the Categories box in this section will refer to Blog Categories. In order to set-up a link in your menu to your blog we recommend the following method: box choose "Blog Template". add to the menu. After you select all your desired categories, go to the right side panel and move your categories (drag-and-drop) under the adequate Custom Post Type. After you
In administration go to the Left-Hand Menu and click on Pages>Add New. Enter the title of
your blog (ex. My Blog) and then go to the Page Attributes panel and at the Select Template
Click on the Publish button and return to Appearance>Menus. Here, go to the Pages panel and select My Blog and press the Add to Menu button; then go to Categories and click on the blog categories you want to add to the menu. When you are finished click the Add to "My Blog" item. When you are ready, just press "Save Menu" and go to your website to check the new menu. Menu button and go to the right-hand panel to arrange the newly added categories under
If one or more panels referred in this documentation are not initially available, click on Screen Options and select them by checking the adequate checkbox.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
40
DEVELOPERS
wpEventful is a complex Events Management System with predefined themes and many features created to build, manage and develop Events orientated websites. Technologies used: HTML 5 / CSS 3 / jQuery / PHP / WordPress 3.5+. If you want to modify the code please do so ONLY if you have good understanding of these technologies.
/admin/contacts.php the Contacts custom post type definition and the functions used for that custom post type /admin/events.php the Events custom post type definition and the functions used for that custom post type /admin/locations.php the Locations custom post type definition and the functions used for that custom post type /admin/portofolios.php the portfolios custom post type definition and the functions used for that custom post type /admin/posts.php the functions used for the normal posts /admin/custom_ajax.php file that contains the Ajax functionality for both the administration and front-end sections /admin/menus.php file that contains the menu configuration /admin/nav_menu_cpt.php file that adds custom post type functionality to the menu /admin/shortcodes-edit.php file that contains the administration of the Shortcodes in the backend /admin/shortcodes.php file that contains the Shortcodes definitions
DOCUMENTATION
41
/admin/sidebars.php file that contains the sidebars definitions /admin/theme-options.php file that the theme options panel /admin/theme_comments.php file that contains the comments functions /admin/widgets.php file that the theme custom widgets /admin/css - folder that contains custom backend styles /admin/style.css backend style
/admin/images - folder that contains custom backend images /images/ - holds the image resources used for the theme
/js/ - holds various JavaScript scripts used by the theme /languages/ - holds the theme localization files
404.php - the template used for the Page Not Found error message archive.php - the template for the default WordPress post types footer.php - the footer template of the theme
archive-*.php - the templates used for the custom post type (artists, locations, events, portfolios)
comments.php - the template used for the comments box in the theme posts (post type = post/page/artists/locations/events/portfolios)
functions.php - holds the theme custom post types and taxonomies definitions and other functions used by the theme home.php - the homepage template of the theme header.php - the header template of the theme
index.php - the index page template of the theme. Mostly used for displaying search results.
DOCUMENTATION
42
page.php - the template used for default pages page- events_archive.php - the template used for the events archive page-contact.php - the template used for the contact page searchform.php - the search form template used in the search widget
sidebar*.php - the templates for the custom sidebars used by the theme single-*.php - the templates for displaying the custom post type entries style_colors_custom.php dynamic style file that sets the appearance color options from the theme settings panel
style_fonts.php dynamic style file that sets the appearance font options from the theme settings panel taxonomy-*.php - the templates used for the eventful custom post type (artists, locations, events, portfolios) custom categories - for more documentation check: http://codex.wordpress.org/Template_Hierarchy#Custom_Taxonomies_display
All the themes are coded and validated with HTML5 and CSS3. marked at the beginning and at the end with:
Main styles are defined in style.css file. The file is well commented and every individual section is /*SECTION NAME*/ /*SECTION NAME*/ CSS Code
If you wish to modify the style of your theme we highly recommend you to use the options available in the DWS Configuration Panel. This way you will be able to update your theme to the latest version without over writing your custom modifications.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
43
PLEASE NOTE: We recommend a good understanding of chapter Files & Hierarchy of this documentation as well as CSS3 at an advanced level before you modify the themes. Also, please note that you can contact us to receive a time & price quote for any custom modification you want for our products.
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com
44
COPYRIGHT INFORMATION
Our Premium WordPress Theme uses several copyrighted materials:
permit persons to whom the Software is furnished to do so, subject to The above copyright notice and this permission notice shall be
DOCUMENTATION
45
included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
js/jquery.easing.min.js - Copyright 2008 George McGinley Smith - All rights reserved. js/jquery.flexslider-min.js - jQuery FlexSlider v2.1 Copyright 2012 WooThemes Contributing Author: Tyler Smith
Open source under the BSD License. JQuery Easing v1.3 - http://gsgd.co.uk/sandbox/jquery/easing/
FlexSlider now shares the common licensed used for all WooThemes themes, GPLv2. js/jquery.imagesloaded.min.js - jQuery imagesLoaded plugin v2.1. http://github.com/desandro/imagesloaded MIT License. by Paul Irish et al.
js/jquery.lightbox-0.5.min.js, admin/js/jquery.lightbox-0.5.min.js - author Leandro Vieira Pinho http://leandrovieira.com js/jquery.snippet.min.js - Snippet :: jQuery Syntax Highlighter v2.0.0 http://steamdev.com/snippet Copyright 2011, SteamDev http://creativecommons.org/licenses/by-sa/2.5/br/deed.en_US
js/jquery.tools.min.js - jQuery Tools v1.2.7 - The missing UI library for the Web
http://www.opensource.org/licenses/mit-license.php
DOCUMENTATION
46
js/jquery.vegas.js - http://vegas.jaysalvat.com/ Dual licensed under the MIT (http://www.opensource.org/licenses/mit-license.php) and GPL js/respond.min.js - Test a CSS media type/query in JS. Authors & copyright (c) 2012: Scott Jehl, Paul Irish, Nicholas Zakas. Dual MIT/BSD license Dual licensed under the MIT or GPL Version 2 licenses. http://www.opensource.org/licenses/gpl-2.0.php Copyright 2012 Jon Rohan, James M. Greene, . Released under the MIT license http://jonrohan.github.com/ZeroClipboard/ http://www.opensource.org/licenses/mit-license.php js/scroll.js - Tiny Scrollbar http://www.baijs.nl/tinyscrollbar/ (http://www.opensource.org/licenses/gpl-license.php) licenses.
js/ZeroClipboard.swf - The Zero Clipboard library provides an easy way to copy text to the clipboard using an invisible Adobe Flash movie, and a JavaScript interface.
admin/js/jquery-ui-1.9.2.custom.min.js - Copyright 2011, AUTHORS.txt (http://jqueryui.com/about) Dual licensed under the MIT or GPL Version 2 licenses. http://jquery.org/license admin/js/jquery-ui-timepicker-addon.js - Copyright 2011 Trent Richardson LICENSE.txt http://trentrichardson.com/Impromptu/MIT-LICENSE.txt
Dual licensed under the MIT and GPL licenses. http://trentrichardson.com/Impromptu/GPLadmin/js/jquery.validate.min.js - Copyright (c) 2006 - 2011 Jrn Zaefferer http://www.gnu.org/licenses/gpl.html
DOCUMENTATION
PHOTOEVENTFUL - WORDPRESS PREMIUM THEME Version 1.0 wpEventful - Advanced Events Manager Version 2.0 www.wpeventful.com