/**
* Renders the Troubleshooting page.
*
* @since 4.14.2
*
*/
public function do_menu_page() {
tribe_asset_enqueue( 'tribe-admin-help-page' );
$main = Tribe__Main::instance();
include_once Tribe__Main::instance()->plugin_path . 'src/admin-views/troubleshooting.php';
}
/**
* This method checks if there are any active issues that need to be flagged.
*
* @since 4.14.2
*
* @return boolean returns true if there are any active issues.
*/
public function is_any_issue_active() {
$issues = $this->get_issues_found();
$active_issues = wp_list_pluck( $issues, 'active' );
return in_array( true, $active_issues );
}
/**
* Checks if any active TEC plugins require an update.
*
* @since 4.14.2
*
* @return boolean returns true is any of the plugins requires an update.
*/
public function is_any_tec_plugin_out_of_date() {
$current = get_site_transient( 'update_plugins' );
$plugins = [];
if ( defined( 'TRIBE_EVENTS_FILE' ) ) {
$plugins[] = TRIBE_EVENTS_FILE;
}
if ( defined( 'EVENTS_CALENDAR_PRO_FILE' ) ) {
$plugins[] = EVENTS_CALENDAR_PRO_FILE;
}
if ( defined( 'EVENT_TICKETS_PLUS_FILE' ) ) {
$plugins[] = EVENT_TICKETS_PLUS_FILE;
}
if ( defined( 'EVENTS_VIRTUAL_FILE' ) ) {
$plugins[] = EVENTS_VIRTUAL_FILE;
}
if ( defined( 'EVENT_TICKETS_MAIN_PLUGIN_FILE' ) ) {
$plugins[] = EVENT_TICKETS_MAIN_PLUGIN_FILE;
}
if ( defined( 'TRIBE_EVENTS_FILTERBAR_FILE' ) ) {
$plugins[] = TRIBE_EVENTS_FILTERBAR_FILE;
}
if ( defined( 'EVENTS_COMMUNITY_TICKETS_FILE' ) ) {
$plugins[] = EVENTS_COMMUNITY_TICKETS_FILE;
}
if ( defined( 'EVENTS_COMMUNITY_FILE' ) ) {
$plugins[] = EVENTS_COMMUNITY_FILE;
}
if ( defined( 'EVENTBRITE_PLUGIN_FILE' ) ) {
$plugins[] = EVENTBRITE_PLUGIN_FILE;
}
if ( defined( 'TRIBE_APM_FILE' ) ) {
$plugins[] = TRIBE_APM_FILE;
}
if ( defined( 'IMAGE_WIDGET_PLUS_DIR' ) ) {
$plugins[] = IMAGE_WIDGET_PLUS_DIR;
}
$plugins = array_map( static function( $file ) {
$file = \str_replace( WP_PLUGIN_DIR . '/', '', $file );
return $file;
}, $plugins );
foreach ( $plugins as $file ) {
if ( ! isset( $current->response[ $file ] ) ) {
continue;
}
$response = $current->response[ $file ];
if ( ! empty( $response->new_version ) ) {
return true;
}
}
return false;
}
/**
* Checks if any of the issues defined are active.
*
* @since 4.14.2
*
* @param string $slug the slug of active issue.
*
* @return boolean returns a boolean value for each individual issue depending on whether it is active or not.
*/
public function is_active_issue( $slug ) {
if ( 'timezone' === $slug ) {
return Timezones::is_utc_offset( Timezones::wp_timezone_string() );
}
if ( 'geolocation' === $slug && class_exists( 'Tribe__Events__Google__Maps_API_Key' ) ) {
$key = \tribe_get_option( 'google_maps_js_api_key', false );
return empty( $key ) || Tribe__Events__Google__Maps_API_Key::$default_api_key === $key ;
}
if ( 'out-of-date' === $slug ) {
return $this->is_any_tec_plugin_out_of_date();
}
return false;
}
/**
* Displays issues found in the UI.
*
* @since 4.14.2
*
* @return array of issues which are displayed on the troubleshooting page.
*/
public function get_issues_found() {
$issues_found = apply_filters( 'tec_help_troubleshooting_issues_found', [
[
'title' => __( 'Site time zone uses UTC', 'tribe-common' ),
'description' => __( 'When using The Events Calendar, we highly recommend that you use a geographic timezone such as "America/Los_Angeles" and avoid using a UTC timezone offset such as “UTC+9”. Choosing a UTC timezone for your site or individual events may cause problems when importing events or with Daylight Saving Time. Go to your the General WordPress settings to adjust your site timezone.', 'tribe-common' ),
'more_info' => 'http://evnt.is/1ad3',
'resolve_text' => __( 'Adjust your timezone', 'tribe-common' ),
'fix' => '/wp-admin/options-general.php',
'active' => $this->is_active_issue( 'timezone' ),
],
[
'title' => __( 'Install max has been reached', 'tribe-common' ),
'description' => __( 'License keys can only be used on a limited number of sites, which varies depending on your license level. You\'ll need to remove the license from one or more other site\'s in order to use it on this one.', 'tribe-common' ),
'more_info' => 'https://evnt.is/1aqz',
'resolve_text' => __( 'Manage your licenses', 'tribe-common' ),
'fix' => 'https://evnt.is/1aq-',
'active' => $this->is_active_issue( 'install-max' ),
],
[
'title' => __( 'Default Google Maps API key', 'tribe-common' ),
'description' => __( 'The Events Calendar comes with an API key for basic maps functionality. If you’d like to use more advanced features like custom map pins, dynamic map loads, or Events Calendar Pro\'s Location Search and advanced Map View, you’ll need to get your own Google Maps API key and add it to Events > Settings > Integrations', 'tribe-common' ),
'more_info' => 'https://evnt.is/1aqx',
'resolve_text' => __( 'Enter a custom API key', 'tribe-common' ),
'fix' => '/wp-admin/edit.php?page=tec-events-settings&tab=addons&post_type=tribe_events#tribe-field-google_maps_js_api_key',
'active' => $this->is_active_issue( 'geolocation' ),
],
[
'title' => __( 'Plugin(s) are out of date', 'tribe-common' ),
'description' => __( 'It\'s important to use the most recent versions of our plugins so that you have access to the latest features, bug fixes, and security updates. Plugin functionality can be comprimised if your site is running outdated or mis-matched versions.', 'tribe-common' ),
'more_info' => 'https://evnt.is/1aqy',
'resolve_text' => __( 'Check for updates', 'tribe-common' ),
'fix' => '/wp-admin/update-core.php',
'active' => $this->is_active_issue( 'out-of-date' ),
],
] );
return $issues_found;
}
/**
* Defines common troubleshooting issues and displays them in the UI.
*
* @since 4.14.2
*
* @return array of common issues which are displayed on the troubleshooting page.
*/
public function get_common_issues() {
$common_issues = apply_filters( 'tec_help_troubleshooting_issues', [
[
'issue' => __( 'Common Error Messages', 'tribe-common' ),
'solution' => __( 'Here’s an overview of %s and what they mean.', 'tribe-common' ),
'link' => 'https://evnt.is/1as0',
'link_label' => 'common error messages',
],
[
'issue' => __( 'My calendar doesn’t look right.', 'tribe-common' ),
'solution' => __( 'This can happen when other plugins try to improve performance. %s.' ),
'link' => 'https://theeventscalendar.com/knowledgebase/k/troubleshooting-the-most-common-installation-issues/#layout-issue',
'link_label' => 'More info',
],
[
'issue' => __( 'I installed the calendar and it crashed my site.', 'tribe-common' ),
'solution' => __( '%s and other common installation issues.', 'tribe-common' ),
'link' => 'https://theeventscalendar.com/knowledgebase/k/troubleshooting-the-most-common-installation-issues/#fatal-errors',
'link_label' => 'Find solutions to this',
],
[
'issue' => __( 'I keep getting “Page Not Found” on events.', 'tribe-common' ),
'solution' => __( 'There are a few %s to resolve and prevent 404 errors.', 'tribe-common' ),
'link' => 'https://evnt.is/1as2',
'link_label' => 'things you can do',
],
] );
return $common_issues;
}
/**
* Fired to display notices in the admin pages where the method is called.
*
* @since 4.14.2
*
* @param string $page the page which the action is being applied.
*
*/
public function admin_notice( $page ) {
do_action( 'tec_admin_notice_area', $page );
}
}
Warning: Cannot modify header information - headers already sent by (output started at /htdocs/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Troubleshooting.php:1) in /htdocs/wp-includes/pluggable.php on line 1435
Warning: Cannot modify header information - headers already sent by (output started at /htdocs/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Troubleshooting.php:1) in /htdocs/wp-includes/pluggable.php on line 1438