documentation wpeventful professional add-on

7/28/2019 Documentation WpEventful Professional Add-On

1/58

1

DOCUMENTATION

wpEventful- Advanced Events Manager Version 2.0

WPEVENTFUL PROFESSIONAL ADD-ON - WORDPRESS PREMIUM PLUG-IN

WPEVENTFUL

PROFESSIONAL ADD-ON

PREMIUM WORDPRESS PLUG-IN

Documentation

This plug-in is an extension to wpEventful Themes

and it will work ONLY with one of our themes available on:

WWW.WPEVENTFUL.COM
http://www.wpeventful.com/http://www.wpeventful.com/http://www.wpeventful.com/http://www.wpeventful.com/http://www.wpeventful.com/http://www.wpeventful.com/


2/58

2

DOCUMENTATION



FEATURES .............................................................................................................................................................................. 3

INSTALLATION .................................................................................................................................................................... 5

YOUR FIRST EVENT ........................................................................................................................................................... 6

YOUR FIRST ARTIST ........................................................................................................................................................ 12

YOUR FIRST LOCATION ................................................................................................................................................. 16

YOUR FIRST ORGANIZER .............................................................................................................................................. 19

YOUR FIRST PORTFOLIO ITEM................................................................................................................................... 22

DWS CONFIGURATION PANEL ................................................................................................................................... 24

SHORTCODES ..................................................................................................................................................................... 41

SIDEBARS & WIDGETS ................................................................................................................................................... 47

MENUS & NAVIGATION .................................................................................................................................................. 50

DEVELOPERS ...................................................................................................................................................................... 52

COPYRIGHT INFORMATION ......................................................................................................................................... 56
http://www.wpeventful.com/http://www.wpeventful.com/http://www.wpeventful.com/http://www.wpeventful.com/


3/58

3

DOCUMENTATION



FEATURES

EVENTS

Simple event Event DurationRecurring

Events

Multiple Dates Events ArchiveUpcoming

Events

Featured

Events

Group Events

ARTISTS

ArtistsFeatured

Artists

Artists

Multiple

Roles

LOCATIONS

Locations

Multiple

Locations per

Event

Parent

Location

Featured

LocationsGoogle Maps


4/58

4

DOCUMENTATION



OTHER FEATURES

Multiple

Layouts

Event

Organizer

Custom

Shortcodes

& Widget


5/58

5

DOCUMENTATION



INSTALLATION

Thank you for purchasing the Professional wpEventful Add-on. This Premium WordPress

Plug-in was created using the wpEventful Platform, an advanced Events Manager System. This

productis an extension to wpEventful Themes that will enable a bundle of powerful features such as

recurrent events, multiple events, multiples locations per event, event organizers, specialized

widgets and Shortcodes, SEO options, etc.

In order to correctly install this product please ensure that you have already installed

the PhotoEventful theme.

Access your WordPress Dashboard and the left-hand menu go to Plugins and click on the

Add New button tab then click on upload link, bellow. Browse to the Professional wpEventful Plug-

in you previously created by un-zipping the archive you downloaded upon purchase. Find the

wpEventful_pro_plugin.zip file, select it and press the Open button; then click on the Install Now

button and wait for the plug-in to upload and then activate it.

Once you uploaded and correctly installed the plug-in, youre all set. All those wonderful

features will be available in different sections of you administration panel and front-end.


6/58

6

DOCUMENTATION



YOUR FIRST EVENT

After you correctly installed your copy of the theme it is time to set up your first event. In

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

you can see a step by step guide how to create your first event.


7/58

7

DOCUMENTATION



STEP 1 EVENT TITLE

Enter you desired title in the default WordPress field and make sure you optimize your

permalink by clicking the edit button and removing any stop words.

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

custom post type such as: Events, Artists, Locations and Organizers. For more on this topic

please see the Shortcodes chapter of this documentation.

STEP 3 EVENTS META BOX

After you entered the content it is time to direct your attention to the Events Meta Box.

Here you can see three tabs: Representations, Artists, Featured.

STEP 3.1 REPRESENTATIONS

wpEventful platform allows you to create a diversity of events. We will present to you

every option available so you can understand which is best suited for your specific needs.

To start you must press +Add New Representation link. This will add an event details box

with the following fields: Recurrence / Start Date / End Date / Duration / Ticket Price /

Location and a Facebook Button that allows you to quickly share the event with your

followers and friends.

With our advanced events management system you can create Daily, Weekly, Monthly or

Yearly events. Here is how these work:


8/58

8

DOCUMENTATION



NO RECURRENCE

This will create a simple event with start date, end date and duration.

DAILY RECURRENCE

When you select this option, wpEventful will create an event that will automatically repeat

its self every day in the period set by entering a start date and end date. With recurrent

events, you can also manually add the duration of the event. This will be shown on front-

end of your website.

WEEKLY RECURRENCE

This option gives you the ability to create a repeating event on a certain day of the week.

Also you must select the start date and the end date under the duration fields.

MONTHLY RECURRENCE

This option gives you the ability to create a repeating event on a certain day of the month.

What you need to do is to set the recurrence monthly, select the start date with the hour

and minutes along with the end date.

YEARLY RECURRENCE

This option gives you the ability to create a repeating event on a certain day of the year.

What you need to do is to set the recurrence yearly, select the start date with the hour and

minutes along with the end date.

MULTIPLE DATES

Another great feature of wpEventful platform gives you the possibility to create multiple

representations of your event. In order to do so, all you have to do is to click on the +Add

New Representation link and another Event Representation box will appear. By using this

powerful tool you can create unlimited number of representations for each event without


9/58

9

DOCUMENTATION



having to duplicate your content. This feature greatly improves the usability of your event

oriented website and optimizes the content for better SEO.

MULTIPLE DATES & RECURRENCEwpEventful allows you to make a multitude of configurations for each event. You can

combine multiple dates with recurrence and create complex events such as conferences,

cinema schedules, etc. On www.wpeventful.com you will find many examples that cover a

vast range of situations regarding how to create a simple event or more complex ones.

STEP 3.2 ARTISTS

Another very important aspect of your event is represented by the people/artists involved.

They are the soul of your events and you may need to display them interconnected with

the locations they appear on, representations and contractors/organizers. With

wpEventful platform you can create roles for your artists using categories, show upcoming

representations and create a repertory for each individual with current and past events.

Not only you will be able to create very complex events oriented websites but you will do

this focusing on providing valuable content for your visitors by showing information that is

already there in multiple forms.

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

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 nameat a time. You dont need to worry about roles at this moment as you can modify this after

you publish your event. Also, when you publish your event, the new artists will be
http://www.wpeventful.com/http://www.wpeventful.com/http://www.wpeventful.com/http://www.wpeventful.com/http://www.wpeventful.com/http://www.wpeventful.com/


10/58

10

DOCUMENTATION



automatically created for your and you can modify them from the Artists section in

WordPress Administration, accessible from the left side menu.

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

can add the name of your artist in the title field, a description, featured image, set up the

categories that will act as roles, and configure many other features.

For a detailed step-by-step guide on how to create and modify your Artists please see Your

first artistsection of this documentation.

Step 3.3 Featured Event

When you have a list of events you may wish to promote some of them. We wanted to offer

you the possibility to highlight certain events so we added in the Events Meta box a section

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..

Step 4 SEO Meta Box

These days, every good website needs extensive SEO work and customization. wpEventful

platform offers you the possibility to customize a bundle of aspects of your website through

different techniques. In order to increase the visibility of your events on search engines, we

added the SEO Meta box where you can modify the default description and add specific

keywords. Every keyword must be comma separated. These options will increase the

relevance of every event and add more juice to your content.

Step 5 Event Categories

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


11/58

11

DOCUMENTATION



multiple categories. Also, if you need a new category, you can create one directly from the

Edit Event page.

Step 6 Featured Image

Another default WordPress option is the Featured Image Meta box. If you do not add an

image to your event, wpEventful will add a default "no-image" picture. Since WordPress

does such a good job to resize images we would only want to recommend you not to use

images bigger then 1400px width or to check the file upload limit on your server.

Step 6 OrganizerUsually events are held by individuals, organizations, companies, etc. You can select the

Organizer/s from a list created previously. If you select an organizer, the event will show in

front-end under that organizer.

Please read section Your First Organizerof this documentation.


12/58

12

DOCUMENTATION



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,

you can highlight certain artists from your database by using the featured options available

in Add New Artist page.

In the section Your First Event, you discovered how easy it is to create a new artist directly

from Add New Event page and now we will present to you a second, more in-depth method

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

Artists > Add Artist link. This will open the Add New Artist page and all you have to do is

follow the next steps:

Step 1 Artist Name

In the title field enter the name of your artist.

Step 2 Artist Description

Next you can add a description of your artist 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 especially for

the Artists custom post-type, please see the Shortcodes section of this documentation.


13/58

13

DOCUMENTATION



Step 3 Artist Meta Box

Go to the Artist Meta box and fill the available fields. Under Artists Information tab you will

be able to enter info about the artists date of birth, gender and his/her website. All these

details will appear in the Artist Details Shortcode. If you click on the Featured tab, you will

be able to highlight that artist on your website. If you miss or simply dont want to

complete any or part of this information wpEventful will just ignore those blank fields.


14/58

14

DOCUMENTATION



Step 4 SEO Meta Box

wpEventful platform offers you the possibility to customize a bundle of aspects of your

website through different techniques. In order to increase the visibility of your events on

search engines, we added the SEO Meta box where you can modify the default description

and add specific keywords. Every keyword must be comma separated. These options will

increase the relevance of every event and add more juice to your content.

Step 5 Artist Categories

Categories in Artists custom post-type were designed to give you the possibility to add

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

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

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 directorin 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 from the Add/Edit Artist page

or go into the left hand menu and click on Artist > Artist Categories.


15/58

15

DOCUMENTATION




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.


16/58

16

DOCUMENTATION



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

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

spaces/rooms/halls that might be available.

You will need to start from the left side menu in you WordPress Dashboard by clicking on

Locations > Add Location link. This will open the Add New Location page and all you have

to do is follow the next steps:

Step 1 Location Name

In the title field enter the name of your location.

Step 2 Location DescriptionNext 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

especially for the Location custom post-type, please see the Shortcodes section of this

documentation.


17/58

17

DOCUMENTATION



Step 3 Location Meta Box

Go to the Location Meta box and fill the available fields. Under Address tab you will be able

to enter the exact address of your location in order to display it on a Google Map. All

information you enter under the General Information Tab will appear in the Location

Details Shortcode. If you click on the Featured tab, you will be able to highlight that location

on your website. If you miss or simply dont want to complete any or part of this

information wpEventful will just ignore those blank fields.


18/58

18

DOCUMENTATION



Step 4 SEO Meta Box


website through different techniques. In order to increase the visibility of your events on

search engines, we added the SEO Meta box where you can modify the default description

and add specific keywords. Every keyword must be comma separated. These options will

increase the relevance of every event and add more juice to your content.

Step 5 Location Categories

You can group your locations into categories using the default WordPress functionality.

Also, if you need a new category, you can create one directly from the Add/Edit Location

page or go into the left hand menu and click on Locations > Location Categories.

Step 6 Location Options

Here you can add the current location to a parent venue. This will allow you to display

differentspaces/rooms/halls available to one main location.







19/58

19

DOCUMENTATION



YOUR FIRST ORGANIZER

Another great feature of wpEventful is the possibility to add organizers to your events.

Lets say you are building a website to present the cultural activities available in your town.

You will have theaters, NGOs, galleries, etc. that you can define as organizers and add

specific information for each of them. It is best to differentiate organizers as institutions or

different forms of legal organization or even individuals from locations as places or venues.

Step 1 Organizer Name

In the title field enter the name of your organizer.

Step 2 Organizer Description

Next you can add a description of your organizer using either the default WordPress



especially for the Location custom post-type, please see the Shortcodes section of this

documentation.

Step 3 Organizer Meta Box

Go to the Organizer Meta box and fill the available fields as following:

Organizer Information tab: the website of this organizer.

Address tab: The street address of your organizer in order to display it on a Google Map

Organizer Locations tab: You can create a list of locations for each organizer.

Featured tab: Highlights this organizer on the front end of your website.

Repertory: Displays the list of events allocated to this organizer.


20/58

20

DOCUMENTATION




21/58

21

DOCUMENTATION



Step 4 SEO Meta Box


website through different techniques. In order to increase the visibility of your organizers

on search engines, we added the SEO Meta box where you can modify the default

description and add specific keywords. Every keyword must be comma separated. These

options will increase the relevance of every event and add more juice to your content.

Step 5 Organizer CategoriesYou can group your organizers into categories using the default WordPress functionality.

Also, if you need a new category, you can create one directly from the Add/Edit Organizer

page or go into the left hand menu and click on Organizers > Organizer Categories.







22/58

22

DOCUMENTATION



YOUR FIRST PORTFOLIO ITEM

With wpEventful you can choose to create portfolios as independent custom posts without

using the events management structure. This adds more flexibility to your website and

allows you to use the theme for presentation purposes only.

Step 1 Portfolio Name

In the title field enter the name of your portfolio.

Step 2 Portfolio Description

Next you can add a description of your portfolio item using either the default WordPress



especially for the Portfolio custom post-type, please see the Shortcodes section of this

documentation.

Step 3 Portfolio Meta Box

Go to the Organizer Meta box and fill the available fields as following:

General tab: You can add a website URL, clients name and the date of completion for this

project.

Featured tab: Highlights this portfolio item on the front end of your website.


23/58

23

DOCUMENTATION



Step 4 SEO Meta Box


website through different techniques. In order to increase the visibility of your portfolio

items on search engines, we added the SEO Meta box where you can modify the default

description and add specific keywords. Every keyword must be comma separated. These

options will increase the relevance of every event and add more juice to your content.

Step 5 Portfolio Categories

You can group your portfolio items into categories using the default WordPress

functionality.

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.







24/58

24

DOCUMENTATION



DWS CONFIGURATION PANEL

All premium themes come with advanced options to customize various aspects of your WordPresswebsite. We took this in consideration and we created our own configuration platform that will

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

you website.

General SettingsYOUR LOGO / LOGO TYPE / LOGO HTML

These options allow you to choose between html or image logo. If you select Your Logo you

must also upload a .png transparent file. Logo HTML option will display the title of your

website in an html format.

CUSTOM TEXT

In this text area you can add a custom html that will be displayed in a special box on your

website. If you leave this field empty, the box will not be shown.

CONTACT INFO

Insert your email, phone number and address. This information will be displayed on your

front-end site so use only public information.


25/58

25

DOCUMENTATION



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

DISPLAY ADS IN SIDEBAR

If you click to activate this option, you will be able to display the advertising code you have

inserted in the field below - Advertising Code.

ADVERTISING CODE

Here you can insert a wide variety of advertising codes, from simple banner links toAdSense code in order to monetize your website.

We recommend you to use responsive code to display your ads.

ANALYTICS CODE

This will be used in the header to help you track your visitors.

404 - PAGE NOT FOUND CUSTOM TEXT

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.


26/58

26

DOCUMENTATION




27/58

27

DOCUMENTATION



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.

SELECT THEME

We created a couple of pre-defined themes that can be altered using the options bellow.

FONTS

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:

Here you can set the color of the background for the content area of your website.

PRIMARY COLOR

The primary color is the color of the text content.

SECONDARY COLOR

Secondary color is used to set contrast elements through-out the theme.

THIRD COLOR

This option allows you to add more color diversity to your text content.

LINES COLOR

Lines Color allows you control the color of borders, lines and other spacers.


28/58

28

DOCUMENTATION



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

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

modifications.


29/58

29

DOCUMENTATION



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 / ORGANIZERS / PORTFOLIO / BLOG / PAGES

HOMEPAGE

Here you have two main options:

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 imageUpload 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.




30/58

30

DOCUMENTATION



3. Textured backgroundIf 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 backgroundSometimes 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 otherfields are empty. For example if you wish a textured background remove any images Vegas

Slider Images section by clicking the Remove Image link.


31/58

31

DOCUMENTATION




32/58

32

DOCUMENTATION



EVENTS / ARTISTS / LOCATIONS / ORGANIZERS / PORTFOLIO/ BLOG / PAGES

All these custom post types have the same layout options that can be configured differently in order

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 Layoutwill permit you to set the general layout of the

archive and taxonomy pages of each custom post type using three options: no sidebar, with the

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

of variations through-out the theme in order to create a unique look for your website.

Also, using the Select Archive and Taxonomy Pages Top Postoptions you can add a slider to the

top of your every archive / taxonomy page. These sliders will display only featured posts.

Select Single Layoutoption 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.

For more information about the layout of single posts pages please see the Layout Sortcodes chapter of

this documentation.


33/58

33

DOCUMENTATION



Each custom post type allows you to define a unique background as following:

1. Full screen imageUpload an image in Vegas Slider Images section and the theme will display stretch it on full

screen.



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.



3. Textured backgroundIf 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 backgroundSometimes 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

fields are empty. For example if you wish a textured background remove any images Vegas

Slider Images section by clicking the Remove Image link.


34/58

34

DOCUMENTATION




35/58

35

DOCUMENTATION



Slider options

This section of DWS Configuration Panel allows you to tweak different aspects of the sliders

available on you theme. The Background Slider uses jQuery Vegas plug-in and the Top Post Slider

uses the Flexslider by WooThemes.

For more information please see the Copyright chapter of this documentation.


36/58

36

DOCUMENTATION



Social Networks

DWS Configuration Panel allows you to display six social network icons on the front end of your

website that are linked to your Social Accounts.


37/58

37

DOCUMENTATION



Contact

Email and Subject information provided here will be used to send emails to you from the Contact

form. These are mandatory fields.


38/58

38

DOCUMENTATION



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

option to select the Site Language. To find out more about how you can add more languages, please

read the chapter Localization of this documentation.


39/58

39

DOCUMENTATION



Import / Export

If you wish to reinstall the theme, now you can save your settings and reload them whenever you

need them. This feature is a powerful tool so use it carefully because will overwrite any settings

that werent exported.

When you click on Export Settings button, the theme will generate a .txt file that you can download.

After you finish your reinstall just browse for theme_export.txtand click Upload file and import

Button.


40/58

40

DOCUMENTATION



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 likePOEdit.

After translation just upload .MO and .PO files to /language/ directory of your theme.
http://www.wpeventful.com/http://www.wpeventful.com/http://www.poedit.net/http://www.poedit.net/http://www.poedit.net/http://www.poedit.net/http://www.wpeventful.com/http://www.wpeventful.com/


41/58

41

DOCUMENTATION



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 or

Usability Shortcodes created for each custom post type.

All Shortcodes can be easily inserted in your WordPress editor through the Shortcodes

Meta box.

Layout Shortcodes

SHORTCODE SHORTCODE DESCRIPTION

ACCORDIONS 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.

BLOCK QUOTES

AND SPECIAL

BOXES

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 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:

DROPCAPS You can use these six Dropcaps Shortcodes to lead your viewers, usually,

into a paragraph.

HEADINGS 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.


42/58

42

DOCUMENTATION



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.

IMAGE EFFECTS Using Images Shortcode you can apply four kinds of effects on your

images. Using these features you will improve the design of your

webpage.

LISTS 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

Miscellaneous Teaser Shortcode adds a special paragraph. This is idealfor highlighting a catch phrase or a glimpse of your article. It is best to

use this option at the beginning of your post.

SLIDESHOW 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 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.

TABLES 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

needs and expectations. In order to take advantage of these new features we added a new

meta-box called Shortcodes available in Posts, Pages, Events, Locations, Artists, etc. You

simply have to select the required option and you will be guided step by step.


43/58

43

DOCUMENTATION



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.


44/58

44

DOCUMENTATION



Custom Post Type Specific Shortcodes

EVENTS

SHORTCODES

SHORTCODE

DESCRIPTION

Artists Allows you to add to the post a categorized list of all the artists involvedin your event.

[single_event_artists]

Organizers Will display the organizers of this event on front-end.[single_event_organizers]

Featured Image Adds the featured image into your content editor.

[single_featured_image]

Representations Creates a list of all the future representations of your event displayingthe title, period dates, duration and the location of the event.

[single_event_representations_list]

ARTISTS

SHORTCODES

SHORTCODE

DESCRIPTION

Events This Shortcode will display the list of all the events were this artist wasmentioned.[single_artist_events]

Details Adds the general information about your artist to the content area. Inorder to display this information you must first fill the fields available

under Artist Meta Box Artist Information tab.

[single_artist_details]

Featured Image Adds the featured image into your content editor.[single_featured_image]

Representations Creates a list of all the future representations of every event where thisartists is mentioned, displaying the title, period dates, duration and the

location of the event.



45/58

45

DOCUMENTATION



LOCATIONS

SHORTCODES

SHORTCODE

DESCRIPTION

Events This Shortcode will display the list of all the events allocated to this

location.[single_location_events]

Details Adds the general information about your location to the content area. Inorder to display this information you must first fill the fields available

under Location Meta box General Information tab.

[single_location_details]

If this is a parent location you can also display its child locations.

[single_sublocations_list]


Representations Creates a list of all the future representations of every event where thislocation is mentioned, displaying the title, period dates, duration and

the location of the event.


ORGANIZERS

SHORTCODES

SHORTCODE

DESCRIPTION

Events This Shortcode will display the list of all the events allocated to thisorganizer.

[single_organizer_events]

Details Adds the general information about your location to the content area. Inorder to display this information you must first fill the fields available

under Organizer Meta box Organizer Information tab.

[single_organizer_details]


Representations Creates a list of all the future representations of every event where thisorganizer is mentioned, displaying the title, period dates, duration and

the location of the event.



46/58

46

DOCUMENTATION



PORTFOLIOS

SHORTCODES

SHORTCODE

DESCRIPTION

Details Adds the general information about a specific portfolio to the content

area. In order to display this information you must first fill the fieldsavailable under Portfolios Meta box General tab.

[single_portofolio_details]


47/58

47

DOCUMENTATION



SIDEBARS & WIDGETS

Sidebars

Events Sidebar - can be found in Events Custom Post Type related pages such as Events

Archives, Events Categories and Single Event.

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

Locations Archives, Locations Categories and Single Locations.

Organizers Sidebar - can be found in Organizers Custom Post Type related pages such as

Organizers Archives, Organizers Categories and Single Organizers.

Portfolios Sidebar - can be found in Portfolios Custom Post Type related pages such as

Portfolios Archives, Portfolios Categories and Single Portfolios.

Blog Sidebar - is used in blog sections and default pages.


48/58

48

DOCUMENTATION



Widgets

DWS Custom Categories - you can select the custom post type you need to create a

categories list (Events/Locations/Artists/Organizers/Portfolios). This widget can be used

in all sidebars.

DWS Details this widget displays the custom information for custom post types. It works

only for the all the theme custom post types and it is only being displayed in the single

page. The details displayed by this widget are:

- Events: the event organizer- Artists: the artist day of birth, the artist gender, the artist website- Locations: location phone number, location website, location ticket office schedule,

location map

- Organizers: organizer website, organizer location map- 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 first 10 ongoing and future event

representations for the event loaded in the single page. This widget works in the events,

artists, locations and organizers single pages.

DWS Featured Artist - displays the latest featured artist with picture, title and short

description.

DWS Featured Events - its a list of the latest Upcoming Events that can be displayed in all

sidebars. The list contains Event's image, title and the date of the event.

DWS Featured Image - displays the featured image, if available, on any single custom post

type.


49/58

49

DOCUMENTATION



DWS Featured Location - displays a list of featured locations depending on the count that

was set in the widget settings. This widget can be displayed in all sidebars.

DWS Location Sub-locations displays the list of all the sub locations of a location. It can

only be used in the locations single page.


50/58

50

DOCUMENTATION



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

(Locations/Events/Artists/Organizers/Portfolios). When you are finished press the "Add


51/58

51

DOCUMENTATION



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, Organizers Categories, Portfolios Categories and click on the

categories you want to 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 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:

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

box choose "Blog 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 onthe blog categories you want to add to the menu. When you are finished click the Add to

Menu button and go to the right-hand panel to arrange the newly added categories under

"My Blog" item. When you are ready, just press "Save Menu" and go to your website to

check the new menu.

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.


52/58

52

DOCUMENTATION



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.

Files & Hierarchy

Bellow you will find the file structure of your theme:

/admin/artists.php the Artists custom post type definition and the functions used for thatcustom post type

/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/organizers.php the Organizers custom post type definition and the functions used forthat 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/redirects.php file that customizes the default permalink structure

/admin/seo.php file that holds SEO functions used throughout the website


53/58

53

DOCUMENTATION



/admin/shortcodes-edit.php file that contains the administration of the Shortcodes in the

backend

/admin/shortcodes.php file that contains the Shortcodes definitions

/admin/sidebars.php file that contains the sidebars definitions

/admin/theme_comments.php file that contains the comments functions

/admin/theme-options.php file that the theme options panel

/admin/widgets.php file that the theme custom widgets

/admin/style.css backend style

/admin/css - folder that contains custom backend styles

/admin/js - folder that contains custom backend JavaScript files

/admin/images - folder that contains custom backend images

/css/ - holds custom style sheets for the frontend

/images/ - holds the image resources used for the theme

/js/ - holds various JavaScript scripts used by the theme

/include/ - holds files used to display various features of the theme

/languages/ - holdsthe theme localization files

404.php - the template used for the Page Not Found error message

archive-*.php - the templates used for the custom post type (artists, locations, events, organizers,

portfolios)

archive.php - the template for the default WordPress post types

comments.php - the template used for the comments box in the theme posts (post type =

post/page/artists/locations/events/organizers/portfolios)

footer.php - the footer template of the theme

functions.php - holds the theme custom post types and taxonomies definitions and other functions

used by the theme

header.php - the header template of the theme


54/58

54

DOCUMENTATION



home.php - the homepage template of the theme

index.php - the index page template of the theme. Mostly used for displaying search results.

no-ie.php - displays an error message for non-supported browsers

page-contact.php - the template used for the contact page

page-events_archive.php - the template used for the events archive

page.php - the template used for default pages

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,

organizers, portfolios) custom categories - for more documentation check:

http://codex.wordpress.org/Template_Hierarchy#Custom_Taxonomies_display

Styles & Format

All the themes are coded and validated with HTML5 and CSS3.

Main styles are defined in style.css file. The file is well commented and every individual section is

marked at the beginning and at the end with:

/*SECTION NAME*/

CSS Code

/*SECTION NAME*/


55/58

55

DOCUMENTATION



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.

PLEASE NOTE:

We recommend a good understanding of chapterFiles & Hierarchyof this documentation as well as

CSS3 at an advanced levelbefore 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.

HTML & PHPOur themes are coded using features such as Custom Posts Types and Taxonomies available in

WordPress. It has a complicated file system in order to incorporate a variety of features and to offer

a complex yet intuitive events manager system. Please refrain from modifying the structure or code

if you are not well familiarized with PHP/HTML/Java/WordPress and chapter Files & Hierarchy of

this documentation.

All main files are well commented as following:

PHP Code


56/58

56

DOCUMENTATION



COPYRIGHT INFORMATION

Our Premium WordPress Theme uses several copyrighted materials:

Images and photography for demo website ONLY

All the images used for the demonstration website are the exclusive property ofANDREEA

CHIRU, the photographer. She allowed the use of her copyright materials for the sole

purpose and limited to the themes preview, provided that we mention her as the creator of

the images. You cannot use these images on your own website without a written

agreement approved and signed byANDREEA CHIRU.

You can contact her at: http://www.facebook.com/andreea.chiru

Code, Scripts & Plug-ins

js/jquery-ui-datepicker.min.js - Copyright 2011, AUTHORS.txt (http://jqueryui.com/about)

Dual licensed under the MIT or GPL Version 2 licenses. http://jquery.org/license

js/jquery.dropkick-1.0.0.js Copyright (c) 2011 Jamie Lottering, http://github.com/jamielottering

Permission is hereby granted, free of charge, to any person obtaining

a copy of this software and associated documentation files (the

"Software"), to deal in the Software without restriction, including

without limitation the rights to use, copy, modify, merge, publish,

distribute, sublicense, and/or sell copies of the Software, and to

permit persons to whom the Software is furnished to do so, subject to

the following conditions:

The above copyright notice and this permission notice shall be
http://www.wpeventful.com/http://www.wpeventful.com/http://www.facebook.com/andreea.chiruhttp://www.facebook.com/andreea.chiruhttp://www.wpeventful.com/http://www.wpeventful.com/


57/58

57

DOCUMENTATION



included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

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.

Open source under the BSD License. JQuery Easing v1.3 - http://gsgd.co.uk/sandbox/jquery/easing/

js/jquery.flexslider-min.js - jQuery FlexSlider v2.1

Copyright 2012 WooThemes

Contributing Author: Tyler Smith

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

http://creativecommons.org/licenses/by-sa/2.5/br/deed.en_US

js/jquery.snippet.min.js - Snippet :: jQuery Syntax Highlighter v2.0.0

http://steamdev.com/snippet

Copyright 2011, SteamDev

Released under the MIT license.

http://www.opensource.org/licenses/mit-license.php *

js/jquery.tools.min.js - jQuery Tools v1.2.7 - The missing UI library for the Web

Liscensed under the MIT License (MIT-LICENSE.txt)

http://www.opensource.org/licenses/mit-license.php


58/58

58js/jquery.vegas.js - http://vegas.jaysalvat.com/

Dual licensed under the MIT (http://www.opensource.org/licenses/mit-license.php) and GPL

(http://www.opensource.org/licenses/gpl-license.php) licenses.

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

js/scroll.js - Tiny Scrollbar http://www.baijs.nl/tinyscrollbar/

Dual licensed under the MIT or GPL Version 2 licenses.

http://www.opensource.org/licenses/mit-license.php

http://www.opensource.org/licenses/gpl-2.0.php

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.

Copyright 2012 Jon Rohan, James M. Greene, .

Released under the MIT license

http://jonrohan.github.com/ZeroClipboard/

admin/js/colorpicker.js - Author: Stefan Petre www.eyecon.ro

Dual licensed under the MIT and GPL licenses

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

Dual licensed under the MIT and GPL licenses. http://trentrichardson.com/Impromptu/GPL-

LICENSE.txt http://trentrichardson.com/Impromptu/MIT-LICENSE.txt

admin/js/jquery.validate.min.js - Copyright (c) 2006 - 2011 Jrn Zaefferer

Dual licensed under the MIT and GPL licenses: http://www.opensource.org/licenses/mit-license.php

http://www.gnu.org/licenses/gpl.html

WordPress 3.5 - http://codex.wordpress.org/License

Licensed under GNU General Public License - http://www.gnu.org/licenses/gpl.html
http://www.wpeventful.com/

documentation wpeventful professional add-on

Documents