July 21, 2023

The Events Calendar User CSS Plugin

A plugin to correctly load users custom CSS overrides for The Events Calendar PRO.

A plugin to allow users to add custom CSS without having to either copy all existing code from TEC/ECP core CSS files or add the correct @import to their custom CSS.

Correctly load {YOUR_THEME}/tribe-events/tribe-events.css, if it exists, using wp_enqueue_style in proper order when using ECP 3.x.

Installation

Create a /tribe-events/tribe-events.css file and directory inside your active theme or child theme directory.
/tribe-events/tribe-events.css only needs to contain the override CSS. No CSS code from any core tribe-events CSS file(s) needs to be duplicated.
Upload the entire /the-events-calendar-user-css/ folder to the /wp-content/plugins/ directory.
Activate the plugin.

FAQ

Does the plugin require The Events Calendar plugin?

Yes. The Events Calendar plugin is written by Modern Tribe, Inc. It requires at least The Events Calendar/Events Calendar PRO v3.x.

Do I really need this?

No, if you’re using The Events Calendar 3.x all you need to do is create the following structure in your theme’s folder, {YOUR_THEME}/tribe-events/tribe-events.css. This file should contain only the override CSS. It will be loaded automatically by TEC 3.0. If you’re trying to override CSS in Events Calendar PRO 3.x then you may need this plugin as the CSS for ECP is loaded after the automatic loading of tribe-events.css. You may also need this plugin if your theme’s CSS is overriding your changes.

Where can I report bugs?

Add a new topic on the WordPress Support Forum.

Changelog

1.5.1 / 2023-07-21

update GA

1.5.0 / 2021-07-07

add @10up GitHub Actions for WordPress SVN

1.4.3

update tested to

1.4.2

fix version constant – oops
update stable tag to trunk

1.4.1

tested to 4.3

1.4.0

Removed requirement for ECP as builtin feature of TEC still doesn’t load the override stylesheet after the theme’s stylesheet.

1.3.0

Set wp_enqueue priority to PHP_INT_MAX to ensure loading last.

1.2.0

Now only works with ECP as there is built-in feature of TEC.

1.1.0

Tested with WP 4.0
Fixed for changes in latest TEC/ECP 3.7 to remove default override file loading.

1.0.0

Tested with WP 3.9 beta
Fixed to remove default TEC loading of override file

0.9.2

Tested with WP 3.8, it works!

0.9.1

Added sanity check to ensure isset( $tec_user_css )

0.9

TEC 3.0 doesn’t quite do it correctly. They automatically load User CSS before their CSS not after. Now works with either folder/file notation.

0.8.2

Only needed for TEC 2.x
Will work for TEC 3.0 if you haven’t created the new folder structure. If you’re using TEC 3.0 go ahead, make the change and deactivate this plugin. 😉

0.8.1

version bump

0.8

fixes for TEC 3.0 compliance
still backwards compatible with TEC 2.x

0.7.1

fixed stupid error in defining constant.

0.7

vastly simplified plugin by checking for existence of CSS override file in pre-determined location and if present, enqueue loading of file.
submitted similar code for review and inclusion into TEC 3.0
no longer needs to create separate file with @import statements.
enqueue loading of default Events Calendar CSS.

0.6.1

prevent tribe-user-css.php from throwing PHP error if loaded directly

0.6

fixes to readme

0.5.9

fixed code that tested for deprecated function get_theme.

0.5.8

code cleanup

0.5.7

fail message to admin_notices

0.5.6

load only with class TribeEvents
continuity with fail message
test for existence of override files
commented out code for Community Events plugin, it seems this is handled internally in the correct manner as of version 1.0.2.

0.5.5

bug fix if TEC not active

0.5.4

better directions in readme, I hope. This plugin will not create any files or directories.
changed deactivate to just warning.

0.5.3

fixes for Community Events plugin

0.5.2

fixes for Community Events plugin

0.5.1

readme updates

0.5

fixes for Community Events plugin

0.4

Major code cleanup, Thanks Daniel Dvorkin

0.3

fixes

0.2

readme fixes

0.1

Initial release.