Support

Home Forums Event Espresso Premium EE4 – How do I customize the Event Listing page?

EE4 – How do I customize the Event Listing page?

Posted: February 22, 2014 at 2:56 pm


atartaglia

February 22, 2014 at 2:56 pm

I’m running the latest release of WordPress and EE4. I just installed EE4 today.

With EE3 my event listing page was pretty simple (by “event listing page” I mean the page that has the “[ESPRESSO_EVENTS]” shortcode). With EE4 the default theme is much more complicated than I would like.

I am having trouble figure out to customize that listings page (http://sjjuniortour.com/tournaments/) so that it looks much simpler and without all the icons and the like. I found the pages below but they are not very straightforward so I am hoping somebody can help.

Thanks in advance!

I already read:
https://eventespresso.com/2014/02/developers-corner-theming-event-espresso-4/


standoutsites

February 22, 2014 at 3:38 pm

Second that, the original template is not looking good. I’d love to customize the look.


BurntCorkMedia

February 23, 2014 at 8:24 am

Yup, I’m also interested. Very confusing for customers in current layout – just a wall of text.

Cheers


Dean

February 24, 2014 at 3:09 am

Hi all,

With the move to Custom Post Types, events are now just posts. As such the styling comes directly from the theme.

This makes them extremely flexible, more so than EE3, but the way they are styled is different.

There are a few ways that you can go about it:

1) Just use CSS. Each event on the event list page has a class called espresso_events. This can be used to add css to break them up.

An example of this, using Atartaglia’s site is this –

This used the following CSS which can be added to the themes style.css or a plugin such as My Custom CSS (I recommend this plugin as it stops theme updates deleting your code)

.espresso_events {
background-color: #eee;
padding: 15px;
border: #666 solid;
}

Screenshot of modified page, zoomed out — http://take.ms/Nt2fe

2) For more complex changes you can add the template files to your themes directory. These are found in event-espresso/templates/Espresso_Arabica_2014.

These on their own may look a bit weird, depending on your theme, as they are specifically for the default twentyfourteen theme.

You can recreate these using your own theme files though. For example, if your theme has an archive.php file, copy it and rename it to archive-espresso_events.php This means that the plugin will use that file over any other for displaying the event list (which is an archive in WordPress terminology).

single.php can be copied and renamed single-event_espresso.php and this will affect the individual event views.

3) The problem with option 2 is that a theme update will over write your files deleting them. So a more robust method is to create a Child Theme https://codex.wordpress.org/Child_Themes and tho copy the template files over to that.

As the post you linked to said, it all comes down to what you actually want to change. Minor changes can be handled via CSS and text filters. Larger changes will need the template files modifying.

We do have a list of recommended developers that can assist you with modifying the templates – https://eventespresso.com/developers/event-espresso-pros/


atartaglia

February 24, 2014 at 7:51 am

Thanks for the update. The CSS updates weren’t as much as my concern (that is the easy part in my eyes) but more the way the content is laid out on the page. To continue the example that you shared, I would like the event listing page to be much simpler. I would rather it simply read like the format below.

Since this is a template based system, my expectation is that this update is possible. Please let me know.

EVENT LISTING PAGE

Event Title
Date: MM/DD/YYYY
Time: HH:MM
Venue: Venue Name Here
Address:
Venue Address
Map of Address

Options:
Option 1 (O)
Option 2 (O)
Option 3 (O)
[REGISTER NOW]


Josh

  • Support Staff

February 24, 2014 at 2:58 pm

Hi there,

Of course it’s possible. It sounds like you’re looking to remove what’s already there (not add anything new). Is that correct?


atartaglia

February 24, 2014 at 4:54 pm

That is correct. I want to remove some info that isn’t configurable from the admin panel, and reorganize what remains into something more logical for my site.


Josh

  • Support Staff

February 24, 2014 at 7:39 pm

Hi there,

As Dean mentioned earlier option #1 would be to use CSS.

Option #2 would be to create a child theme based off your your current WordPress theme and copy over some templates from the Event Espresso plugin.

The templates that you’ll copy are from the event-espresso/templates/Espresso_Arabica_2014/ folder and they include:

archive-espresso_events.php
content-espresso_events-datetimes.php
content-espresso_events-details.php
content-espresso_events-tickets.php
content-espresso_events-venues.php
content-espresso_events.php
functions.php
loop-espresso_events.php

The template that handles the actual layout of the event list is content-espresso_events.php. You can remove and move things around within that template. Any style changes can go into the child theme’s style.css file.


atartaglia

March 4, 2014 at 11:10 am

Is this also the best way to update the language on the page or do I need to edit the PO file?


Josh

  • Support Staff

March 4, 2014 at 1:46 pm

It depends. Usually we recommend changing text strings via the translation functions. But if you’re already editing the template, you can keep things simple by making your edits to the template. A good rule of thumb is if you need to change a text string and it’s in a template that you’re not already editing, changing via a translation function is better.

https://eventespresso.com/wiki/how-to-change-wording-with-poedit/


atartaglia

March 9, 2014 at 10:06 am

Thanks for the tips. I used a combination of the above and am all good now.

Thanks.

The support post ‘EE4 – How do I customize the Event Listing page?’ is closed to new replies.

Have a question about this support post? Create a new support post in our support forums and include a link to this existing support post so we can help you.

Event Espresso