Manager

Back Back Up Advanced Editor

<?php
/**
 * Welcome Page Class
 *
 * Shows a feature overview for the new version (major) and credits.
 *
 * Adapted from code in EDD (Copyright (c) 2012, Pippin Williamson) and WP.
 *
 * @author    ThemeBoy
 * @category  Admin
 * @package   SportsPress/Admin
 * @version   2.7.13
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit; // Exit if accessed directly
}

/**
 * SP_Admin_Welcome class.
 */
class SP_Admin_Welcome {

private $plugin;

/**
	 * __construct function.
	 *
	 * @access public
	 * @return void
	 */
	public function __construct() {
		$this->plugin = 'sportspress/sportspress.php';

add_action( 'admin_menu', array( $this, 'admin_menus' ) );
		add_action( 'admin_head', array( $this, 'admin_head' ) );
		add_action( 'admin_init', array( $this, 'welcome' ) );
	}

/**
	 * Add admin menus/screens
	 *
	 * @access public
	 * @return void
	 */
	public function admin_menus() {
		if ( empty( $_GET['page'] ) ) {
			return;
		}

$welcome_page_name  = esc_attr__( 'About SportsPress', 'sportspress' );
		$welcome_page_title = esc_attr__( 'Welcome to SportsPress', 'sportspress' );

switch ( $_GET['page'] ) {
			case 'sp-about':
				$page = add_dashboard_page( $welcome_page_title, $welcome_page_name, 'manage_options', 'sp-about', array( $this, 'about_screen' ) );
				add_action( 'admin_print_styles-' . $page, array( $this, 'admin_css' ) );
				break;
			case 'sp-credits':
				$page = add_dashboard_page( $welcome_page_title, $welcome_page_name, 'manage_options', 'sp-credits', array( $this, 'credits_screen' ) );
				add_action( 'admin_print_styles-' . $page, array( $this, 'admin_css' ) );
				break;
			case 'sp-translators':
				$page = add_dashboard_page( $welcome_page_title, $welcome_page_name, 'manage_options', 'sp-translators', array( $this, 'translators_screen' ) );
				add_action( 'admin_print_styles-' . $page, array( $this, 'admin_css' ) );
				break;
		}
	}

/**
	 * admin_css function.
	 *
	 * @access public
	 * @return void
	 */
	public function admin_css() {
		wp_enqueue_style( 'sportspress-activation', plugins_url( '/assets/css/activation.css', SP_PLUGIN_FILE ), array(), SP_VERSION );
	}

/**
	 * Add styles just for this page, and remove dashboard page links.
	 *
	 * @access public
	 * @return void
	 */
	public function admin_head() {
		remove_submenu_page( 'index.php', 'sp-about' );
		remove_submenu_page( 'index.php', 'sp-credits' );
		remove_submenu_page( 'index.php', 'sp-translators' );
	}

/**
	 * Into text/links shown on all about pages.
	 *
	 * @access private
	 * @return void
	 */
	private function intro() {

// Flush after upgrades
		if ( ! empty( $_GET['sp-updated'] ) || ! empty( $_GET['sp-installed'] ) ) {
			flush_rewrite_rules();
		}

// Get major version number
		$version = explode( '.', SP()->version, 3 );
		unset( $version[2] );
		$display_version = implode( '.', $version );
		?>
	<h1 class="sp-welcome-logo"><?php echo wp_kses_post( apply_filters( 'sportspress_logo', '<img src="' . plugin_dir_url( SP_PLUGIN_FILE ) . 'assets/images/welcome/sportspress' . ( class_exists( 'SportsPress_Pro' ) ? '-pro' : '' ) . '.png" alt="' . esc_attr__( 'SportsPress', 'sportspress' ) . '">' ) ); ?></h1>

<div class="sp-badge"><?php printf( esc_html__( 'Version %s', 'sportspress' ), esc_html( SP()->version ) ); ?></div>

<div class="about-text sp-about-text">
		<?php
		if ( ! empty( $_GET['sp-installed'] ) ) {
			$message = esc_attr__( 'Thanks, all done!', 'sportspress' );
		} elseif ( ! empty( $_GET['sp-updated'] ) ) {
			$message = esc_attr__( 'Thank you for updating to the latest version!', 'sportspress' );
		} else {
			$message = esc_attr__( 'Thanks for installing!', 'sportspress' );
		}

printf( esc_html__( '%1$s SportsPress %2$s has lots of refinements we think you&#8217;ll love.', 'sportspress' ), esc_html( $message ), esc_html( $display_version ) );
		?>
	</div>

<a href="
		  <?php
			echo esc_url( admin_url(
				add_query_arg(
					array(
						'page' => 'sportspress',
						'tab'  => 'general',
					),
					'admin.php'
				)
			) );
			?>
					" class="button button-primary"><?php esc_html_e( 'Settings', 'sportspress' ); ?></a>
	  <a href="<?php echo esc_url( apply_filters( 'sportspress_docs_url', 'http://tboy.co/docs', 'sportspress' ) ); ?>" class="docs button button-primary"><?php esc_html_e( 'Docs', 'sportspress' ); ?></a>
	  <a href="https://twitter.com/share" class="twitter-share-button" data-url="http://wordpress.org/plugins/sportspress" data-text="An open-source (free) #WordPress plugin that helps you build professional league websites" data-via="ThemeBoy" data-size="large" data-hashtags="SportsPress">Tweet</a>
	  <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
	</p>

<h2 class="nav-tab-wrapper">
	  <a class="nav-tab 
		<?php
		if ( sanitize_key( $_GET['page'] ) == 'sp-about' ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput
			echo 'nav-tab-active';}
		?>
		" href="<?php echo esc_url( admin_url( add_query_arg( array( 'page' => 'sp-about' ), 'index.php' ) ) ); ?>">
		<?php esc_html_e( 'Welcome', 'sportspress' ); ?>
	  </a><a class="nav-tab 
		<?php
		if ( sanitize_key( $_GET['page'] ) == 'sp-credits' ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput
			echo 'nav-tab-active';}
		?>
		" href="<?php echo esc_url( admin_url( add_query_arg( array( 'page' => 'sp-credits' ), 'index.php' ) ) ); ?>">
		<?php esc_html_e( 'Credits', 'sportspress' ); ?>
	  </a>
	</h2>
		<?php
	}

/**
	 * Output the about screen.
	 */
	public function about_screen() {
		include_once 'class-sp-admin-settings.php';
		$class = 'chosen-select' . ( is_rtl() ? ' chosen-rtl' : '' );
		?>
	<div class="wrap about-wrap about-sportspress-wrap">

<?php $this->intro(); ?>

<?php
		// Save settings
		if ( isset( $_POST['timezone_string'] ) ) :
			update_option( 'timezone_string', sanitize_text_field( wp_unslash( $_POST['timezone_string'] ) ) );
			update_option( 'sportspress_basic_setup', 1 );
		  endif;
		if ( isset( $_POST['sportspress_sport'] ) && ! empty( $_POST['sportspress_sport'] ) ) :
			$sport = sanitize_text_field( wp_unslash( $_POST['sportspress_sport'] ) );
			SP_Admin_Sports::apply_preset( $sport );
			update_option( 'sportspress_sport', $sport );
			delete_option( '_sp_needs_welcome' );
			update_option( 'sportspress_installed', 1 );
			?>
		<div id="message" class="updated sportspress-message">
		  <p><strong><?php esc_html_e( 'Your settings have been saved.', 'sportspress' ); ?></strong></p>
		</div>
			<?php
		endif;
		if ( isset( $_POST['add_sample_data'] ) ) :
			SP_Admin_Sample_Data::delete_posts();
			SP_Admin_Sample_Data::insert_posts();
		endif;

do_action( 'sportspress_before_welcome_features' );
		?>
	  <div class="feature-section one-col">
		<div class="col">
		  <h2>New Features 🌟</h2>
		</div>
	  </div>

<div class="feature-section three-col">
		<div class="col">
		  <img src="<?php echo esc_url( plugin_dir_url( SP_PLUGIN_FILE ) . 'assets/images/welcome/screenshot-conditional-equations.png' );?>" alt="Screenshot">
		  <h3>Conditional Equations</h3>
		  <p>Use the newly introduced conditional operators <strong>&gt;</strong>, <strong>&lt;</strong>, <strong>&equiv;</strong>, <strong>&ne;</strong>, <strong>&ge;</strong>, and <strong>&le;</strong> to calculate the relationship between variables, then insert that calculation into more complex equations. Visit the <a href="<?php echo esc_url( add_query_arg( array( 'page' => 'sportspress-config' ), admin_url( 'admin.php' ) ) ); ?>">Configure</a> page to edit variables and equations.</p>
		</div>
		<div class="col">
		  <img src="<?php echo esc_url( plugin_dir_url( SP_PLUGIN_FILE ) . 'assets/images/welcome/screenshot-event-specs.png' );?>" alt="Screenshot">
		  <h3>Event Specs</h3>
		  <p>Measure and display additional details per event using the new <strong>Event Specs</strong> variables. They are customizable and can be useful for keeping track of information like player of the match, attendance, and venue weather.
		</div>
		<div class="col">
		  <img src="<?php echo esc_url( plugin_dir_url( SP_PLUGIN_FILE ) . 'assets/images/welcome/screenshot-next-team.png' );?>" alt="Screenshot">
		  <h3>Next Team Column</h3>
		  <p>Provide a quick overview of who each team is playing next using the new <strong>Next Team</strong> preset for <a href="<?php echo esc_url( add_query_arg( array( 'post_type' => 'sp_column' ), admin_url( 'edit.php' ) ) ); ?>">league table columns</a>. This will automatically display the next team's name or logo that links to the next match for each team in the table.<p>
		</div>
	  </div>

<?php if ( ! class_exists( 'SportsPress_Pro' ) ) { ?>
	  <hr>

<div class="feature-section one-col">
		<div class="col">
		  <h2>SportsPress Pro Updates 🏆</h2>
		</div>
	  </div>

<div class="feature-section three-col">
		<div class="col">
		  <img src="<?php echo esc_url( plugin_dir_url( SP_PLUGIN_FILE ) . 'assets/images/welcome/screenshot-results-matrix.png' );?>" alt="Results Matrix">
		  <h3>Results Matrix</h3>
		  <p>Display matches between home and away team in a grid. Create or select an existing calendar and select the <strong>Matrix</strong> layout to convert the calendar to an interactive results matrix!</p>
		</div>
		<div class="col">
		  <img src="<?php echo esc_url( plugin_dir_url( SP_PLUGIN_FILE ) . 'assets/images/welcome/screenshot-midseason-transfers.png' );?>" alt="Midseason Transfers">
		  <h3>Midseason Transfers</h3>
		  <p>Keep track of players that switched teams during a season by adding one or more extra rows to their statistics table. Display the team and partial statistics before and after the transfer.<p>
		</div>
		<div class="col">
		  <img src="<?php echo esc_url( plugin_dir_url( SP_PLUGIN_FILE ) . 'assets/images/welcome/screenshot-vertical-timelines.png' );?>" alt="Vertical Timelines">
		  <h3>Vertical Timelines</h3>
		  <p>Display a match commentary style play-by-play timeline within events. <a href="<?php echo esc_url( apply_filters( 'sportspress_pro_url', 'http://tboy.co/pro' ) ); ?>">Upgrade to SportsPress Pro</a> to get access to <strong>Timelines</strong> and other pro features.<p>
		</div>
	  </div>

<hr>

<div class="feature-section one-col">
		<div class="col">
		  <h2>Player Data Improvements</h2>
		</div>
	  </div>

<div class="feature-section three-col">
		<div class="col">
		  <h3>Player Assignments</h3>
		  <p>Players will now be saved using a new data format that allows them to belong to multiple leagues, seasons, and teams and be accurately selected in <a href="<?php echo esc_url( add_query_arg( array( 'post_type' => 'sp_list' ), admin_url( 'edit.php' ) ) ); ?>">player lists</a>.</p>
		</div>
		<div class="col">
		  <h3>Current Team Column</h3>
		  <p>The <strong>Team</strong> column in player lists will now display only the current team that player belongs to, determined by the <strong>Current Team</strong> setting of each player.</p>
		</div>
		<div class="col">
		  <h3>Squad Number Zero</h3>
		  <p>It's now possible to import players with the squad number <strong>0 (zero)</strong> or any other value that would previously be interpreted as empty.</p>
		</div>
	  </div>

<hr>

<div class="feature-section one-col">
		<div class="col">
		  <h2>Other Notes</h2>
		</div>
	  </div>

<div class="feature-section three-col">
		<div class="col">
		  <h3>Countdown Images</h3>
		  <p>A new option has been added to the <strong>Countdown</strong> widget, allowing you to display a featured image from the next event.</p>
		</div>
		<div class="col">
		  <h3>Relative Date in Shortcodes</h3>
		  <p>You'll now be able to select a relative date range when inserting calendar-related shortcodes from the visual editor.</p>
		</div>
		<div class="col">
		  <h3>Short Names</h3>
		  <p>Teams have been given a <strong>Short Name</strong> setting in addition to the existing <strong>Abbreviation</strong> for added customizability.</p>
		</div>
	  </div>

<?php do_action( 'sportspress_after_welcome_features' ); ?>
		  <a href="
		  <?php
			echo esc_url(
				admin_url(
					add_query_arg(
						array(
							'page' => 'sportspress',
							'tab'  => 'general',
						),
						'admin.php'
					)
				)
			);
			?>
					"><?php esc_html_e( 'Go to SportsPress Settings', 'sportspress' ); ?></a>
	</div>
		<?php
	}

/**
	 * Output the credits.
	 */
	public function credits_screen() {
		?>
	<div class="wrap about-wrap about-sportspress-wrap">
		<?php $this->intro(); ?>
	  
	  <p class="about-description"><?php printf( wp_kses_post( __( 'SportsPress is developed and maintained by a worldwide team of passionate individuals and backed by an awesome developer community. Want to see your name? <a href="%s">Contribute to SportsPress</a>.', 'sportspress' ) ), 'https://github.com/ThemeBoy/SportsPress/blob/master/CONTRIBUTING.md' ); ?></p>

<div class="sp-feature feature-section col one-col">
		<?php echo wp_kses_post( $this->contributors() ); ?>
	  </div>
	</div>
		<?php
	}

/**
	 * Output the translators screen
	 */
	public function translators_screen() {
		?>
	<div class="wrap about-wrap about-sportspress-wrap">

<?php $this->intro(); ?>

<p class="about-description"><?php printf( wp_kses_post( __( 'SportsPress has been kindly translated into several other languages thanks to our translation team. Want to see your name? <a href="%s">Translate SportsPress</a>.', 'sportspress' ) ), 'https://translate.wordpress.org/projects/wp-plugins/sportspress' ); ?></p>
	</div>
		<?php
	}

/**
	 * Render Contributors List
	 *
	 * @access public
	 * @return string $contributor_list HTML formatted list of contributors.
	 */
	public function contributors() {
		$contributors = $this->get_contributors();

if ( empty( $contributors ) ) {
			return '';
		}

$contributor_list = '<ul class="wp-people-group">';

foreach ( $contributors as $contributor ) {
			$contributor_list .= '<li class="wp-person">';
			$contributor_list .= sprintf(
				'<a href="%s" title="%s">',
				esc_url( 'https://github.com/' . $contributor->login ),
				esc_html( sprintf( esc_attr__( 'View %s', 'sportspress' ), $contributor->login ) )
			);
			$contributor_list .= sprintf( '<img src="%s" width="64" height="64" class="gravatar" alt="%s" />', esc_url( $contributor->avatar_url ), esc_html( $contributor->login ) );
			$contributor_list .= '</a>';
			$contributor_list .= sprintf( '<a class="web" href="%s">%s</a>', esc_url( 'https://github.com/' . $contributor->login ), esc_html( $contributor->login ) );
			$contributor_list .= '</a>';
			$contributor_list .= '</li>';
		}

$contributor_list .= '</ul>';

return $contributor_list;
	}

/**
	 * Retrieve list of contributors from GitHub.
	 *
	 * @access public
	 * @return mixed
	 */
	public function get_contributors() {
		$contributors = get_transient( 'sportspress_contributors' );

if ( false !== $contributors ) {
			return $contributors;
		}

$response = wp_remote_get( 'https://api.github.com/repos/ThemeBoy/SportsPress/contributors', array( 'sslverify' => false ) );

if ( is_wp_error( $response ) || 200 != wp_remote_retrieve_response_code( $response ) ) {
			return array();
		}

$contributors = json_decode( wp_remote_retrieve_body( $response ) );

if ( ! is_array( $contributors ) ) {
			return array();
		}

set_transient( 'sportspress_contributors', $contributors, HOUR_IN_SECONDS );

return $contributors;
	}

/**
	 * Sends user to the welcome page on first activation
	 */
	public function welcome() {

// Bail if no activation redirect transient is set
		if ( ! get_transient( '_sp_activation_redirect' ) ) {
			return;
		}

// Delete the redirect transient
		delete_transient( '_sp_activation_redirect' );

// Bail if we are waiting to install or update via the interface update/install links
		if ( get_option( '_sp_needs_update' ) == 1 || get_option( '_sp_needs_pages' ) == 1 ) {
			return;
		}

// Bail if activating from network, or bulk, or within an iFrame
		if ( is_network_admin() || isset( $_GET['activate-multi'] ) || defined( 'IFRAME_REQUEST' ) ) {
			return;
		}

if ( ( isset( $_GET['action'] ) && 'upgrade-plugin' == sanitize_key( $_GET['action'] ) ) && ( isset( $_GET['plugin'] ) && strstr( $_GET['plugin'], 'sportspress.php' ) ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput
			return;
		}

if ( ! get_option( 'sportspress_completed_setup' ) ) {
			wp_redirect( admin_url( 'admin.php?page=sp-setup' ) );
			exit;
		}

wp_redirect( admin_url( 'index.php?page=sp-about' ) );
		exit;
	}
}

new SP_Admin_Welcome();