<?php
/**
* Publicize_UI class.
*
* @package automattic/jetpack-publicize
*/
namespace Automattic\Jetpack\Publicize;
use Automattic\Jetpack\Assets;
/**
* Only user facing pieces of Publicize are found here.
*/
class Publicize_UI {
/**
* Contains an instance of class 'Publicize' which loads Keyring, sets up services, etc.
*
* @var Publicize Instance of Publicize
*/
public $publicize;
/**
* URL to Sharing settings page in wordpress.com
*
* @var string
*/
protected $publicize_settings_url = '';
/**
* Hooks into WordPress to display the various pieces of UI and load our assets
*/
public function __construct() {
global $publicize;
if ( ! is_object( $publicize ) ) {
$publicize = new Publicize();
}
$this->publicize = $publicize;
add_action( 'init', array( $this, 'init' ) );
}
/**
* Initialize UI-related functionality.
*/
public function init() {
$this->publicize_settings_url = $this->publicize->publicize_connections_url();
// Show only to users with the capability required to manage their Publicize connections.
if ( ! $this->publicize->current_user_can_access_publicize_data() ) {
return;
}
// Assets (css, js).
add_action( 'load-settings_page_sharing', array( $this, 'load_assets' ) );
add_action( 'admin_head-post.php', array( $this, 'post_page_metabox_assets' ) );
add_action( 'admin_head-post-new.php', array( $this, 'post_page_metabox_assets' ) );
// Management of publicize (sharing screen, ajax/lightbox popup, and metabox on post screen).
add_action( 'pre_admin_screen_sharing', array( $this, 'admin_page' ) );
add_action( 'post_submitbox_misc_actions', array( $this, 'post_page_metabox' ) );
}
/**
* If the ShareDaddy plugin is not active we need to add the sharing settings page to the menu still
*/
public function sharing_menu() {
add_submenu_page(
'options-general.php',
esc_html__( 'Sharing Settings', 'jetpack-publicize-pkg' ),
esc_html__( 'Sharing', 'jetpack-publicize-pkg' ),
'publish_posts',
'sharing',
array( $this, 'wrapper_admin_page' )
);
}
/**
* Add admin page with wrapper.
*/
public function wrapper_admin_page() {
if ( class_exists( 'Jetpack_Admin_Page' ) ) {
\Jetpack_Admin_Page::wrap_ui( array( $this, 'management_page' ) );
}
}
/**
* Management page to load if Sharedaddy is not active so the 'pre_admin_screen_sharing' action exists.
*/
public function management_page() {
?>
<div class="wrap">
<div class="icon32" id="icon-options-general"><br /></div>
<h1><?php esc_html_e( 'Sharing Settings', 'jetpack-publicize-pkg' ); ?></h1>
<?php
/** This action is documented in modules/sharedaddy/sharing.php */
do_action( 'pre_admin_screen_sharing' );
?>
</div>
<?php
}
/**
* Styling for the sharing screen and popups
* JS for the options and switching
*/
public function load_assets() {
if ( class_exists( 'Jetpack_Admin_Page' ) ) {
\Jetpack_Admin_Page::load_wrapper_styles();
}
}
/**
* Lists the current user's publicized accounts for the blog
* looks exactly like Publicize v1 for now, UI and functionality updates will come after the move to keyring
*/
public function admin_page() {
?>
<h2 id="publicize"><?php esc_html_e( 'Jetpack Social', 'jetpack-publicize-pkg' ); ?></h2>
<p><?php esc_html_e( 'Connect social media services to automatically share new posts.', 'jetpack-publicize-pkg' ); ?></p>
<h4>
<?php
printf(
wp_kses(
/* translators: %s is the link to the Publicize page in Calypso */
__( "We've made some updates to Jetpack Social. Please visit the <a href='%s' class='jptracks' data-jptracks-name='legacy_publicize_settings'>WordPress.com sharing page</a> to manage your Jetpack Social connections or use the button below.", 'jetpack-publicize-pkg' ),
array(
'a' => array(
'href' => array(),
'class' => array(),
'data-jptracks-name' => array(),
),
)
),
esc_url( $this->publicize->publicize_connections_url() )
);
?>
</h4>
<a href="<?php echo esc_url( $this->publicize->publicize_connections_url() ); ?>" class="button button-primary jptracks" data-jptracks-name='legacy_publicize_settings'><?php esc_html_e( 'Jetpack Social Settings', 'jetpack-publicize-pkg' ); ?></a>
<?php
}
/**
* CSS for styling the publicize message box and counter that displays on the post page.
* There is also some JavaScript for length counting and some basic display effects.
*/
public function post_page_metabox_assets() {
// We don't need those assets for the block editor pages.
$current_screen = get_current_screen();
if ( $current_screen && $current_screen->is_block_editor ) {
return;
}
Assets::register_script(
'jetpack-social-classic-editor-connections',
'../build/classic-editor-connections.js',
__FILE__,
array(
'in_footer' => true,
'enqueue' => true,
'textdomain' => 'jetpack-publicize-pkg',
)
);
wp_add_inline_script(
'jetpack-social-classic-editor-connections',
'var jetpackSocialClassicEditorConnections = ' . wp_json_encode(
array(
'ajaxUrl' => admin_url( 'admin-ajax.php' ),
'connectionsUrl' => esc_url( $this->publicize_settings_url ),
)
),
'before'
);
$default_prefix = $this->publicize->default_prefix;
$default_prefix = preg_replace( '/%([0-9])\$s/', "' + %\\1\$s + '", esc_js( $default_prefix ) );
$default_message = $this->publicize->default_message;
$default_message = preg_replace( '/%([0-9])\$s/', "' + %\\1\$s + '", esc_js( $default_message ) );
$default_suffix = $this->publicize->default_suffix;
$default_suffix = preg_replace( '/%([0-9])\$s/', "' + %\\1\$s + '", esc_js( $default_suffix ) );
$max_length = defined( 'JETPACK_PUBLICIZE_TWITTER_LENGTH' ) ? JETPACK_PUBLICIZE_TWITTER_LENGTH : 280;
$max_length = $max_length - 24; // t.co link, space.
?>
<script type="text/javascript">
jQuery( function($) {
var wpasTitleCounter = $( '#wpas-title-counter' ),
wpasTwitterCheckbox = $( '.wpas-submit-twitter' ).length,
postTitle = $( '#title' ),
wpasTitle = $( '#wpas-title' ).keyup( function() {
var postTitleVal,
length = wpasTitle.val().length;
if ( ! length ) {
length = wpasTitle.attr( 'placeholder' ).length;
}
wpasTitleCounter.text( length ).trigger( 'change' );
} ),
authClick = false;
wpasTitleCounter.on( 'change', function( e ) {
if ( wpasTwitterCheckbox && parseInt( $( e.currentTarget ).text(), 10 ) > <?php echo (int) $max_length; ?> ) {
wpasTitleCounter.addClass( 'wpas-twitter-length-limit' );
} else {
wpasTitleCounter.removeClass( 'wpas-twitter-length-limit' );
}
} );
// Keep the postTitle and the placeholder in sync
postTitle.on( 'keyup', function( e ) {
var url = $( '#sample-permalink' ).text();
<?php // phpcs:ignore ?>
var defaultMessage = $.trim( '<?php printf( $default_prefix, 'url' ); printf( $default_message, 'e.currentTarget.value', 'url' ); printf( $default_suffix, 'url' ); ?>' )
.replace( /<[^>]+>/g,'');
wpasTitle.attr( 'placeholder', defaultMessage );
wpasTitle.trigger( 'keyup' );
} );
// set the initial placeholder
postTitle.trigger( 'keyup' );
// If a custom message has been provided, open the UI so the author remembers
if ( wpasTitle.val() && ! wpasTitle.prop( 'disabled' ) && wpasTitle.attr( 'placeholder' ) !== wpasTitle.val() ) {
$( '#publicize-form' ).show();
$( '#publicize-defaults' ).hide();
$( '#publicize-form-edit' ).hide();
}
$('#publicize-disconnected-form-show').click( function() {
$('#publicize-form').slideDown( 'fast' );
$(this).hide();
} );
$('#publicize-disconnected-form-hide').click( function() {
$('#publicize-form').slideUp( 'fast' );
$('#publicize-disconnected-form-show').show();
} );
$('#publicize-form-edit').click( function() {
$('#publicize-form').slideDown( 'fast', function() {
var selBeg = 0, selEnd = 0;
wpasTitle.focus();
if ( ! wpasTitle.text() ) {
wpasTitle.text( wpasTitle.attr( 'placeholder' ) );
selBeg = wpasTitle.text().indexOf( postTitle.val() );
if ( selBeg < 0 ) {
selBeg = 0;
} else {
selEnd = selBeg + postTitle.val().length;
}
var domObj = wpasTitle.get(0);
if ( domObj.setSelectionRange ) {
domObj.setSelectionRange( selBeg, selEnd );
} else if ( domObj.createTextRange ) {
var r = domObj.createTextRange();
r.moveStart( 'character', selBeg );
r.moveEnd( 'character', selEnd );
r.select();
}
}
} );
$('#publicize-defaults').hide();
$(this).hide();
return false;
} );
$('#publicize-form-hide').click( function() {
var newList = $.map( $('#publicize-form').slideUp( 'fast' ).find( ':checked' ), function( el ) {
return $.trim( $(el).parent( 'label' ).text() );
} );
$('#publicize-defaults').html( '<strong>' + newList.join( '</strong>, <strong>' ) + '</strong>' ).show();
$('#publicize-form-edit').show();
return false;
} );
$('.authorize-link').click( function() {
if ( authClick ) {
return false;
}
authClick = true;
$(this).after( '<img src="images/loading.gif" class="alignleft" style="margin: 0 .5em" />' );
$.ajaxSetup( { async: false } );
if ( window.wp && window.wp.autosave ) {
window.wp.autosave.server.triggerSave();
} else {
autosave();
}
return true;
} );
$( '.pub-service' ).click( function() {
var service = $(this).data( 'service' ),
fakebox = '<input id="wpas-submit-' + service + '" type="hidden" value="1" name="wpas[submit][' + service + ']" />';
$( '#add-publicize-check' ).append( fakebox );
} );
} );
</script>
<style type="text/css">
#publicize {
line-height: 1.5;
}
#publicize ul {
margin: 4px 0 4px 6px;
}
#publicize li {
margin: 0;
}
#publicize textarea {
margin: 4px 0 0;
width: 100%
}
#publicize ul.not-connected {
list-style: square;
padding-left: 1em;
}
.wpas-disabled {
color: #999;
}
.publicize__notice-warning {
display: block;
padding: 7px 10px;
margin: 5px 0;
border-left-width: 4px;
border-left-style: solid;
font-size: 12px;
box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.1);
}
.publicize-external-link {
display: block;
text-decoration: none;
margin-top: 8px;
}
.publicize-external-link__text {
text-decoration: underline;
}
#publicize-title:before {
content: "\f237";
font: normal 20px/1 dashicons;
speak: none;
margin-left: -1px;
padding-right: 3px;
vertical-align: top;
-webkit-font-smoothing: antialiased;
color: #8c8f94;
}
.post-new-php .authorize-link, .post-php .authorize-link {
line-height: 1.5em;
}
.post-new-php .authorize-message, .post-php .authorize-message {
margin-bottom: 0;
}
#poststuff #publicize .updated p {
margin: .5em 0;
}
.wpas-twitter-length-limit {
color: red;
}
.publicize__notice-warning .dashicons {
font-size: 16px;
text-decoration: none;
}
</style>
<?php
}
/**
* Get the connection label.
*
* @param string $service_label Service's human-readable Label ("Facebook", "Twitter", ...).
* @param string $display_name Connection's human-readable Username ("@jetpack", ...).
* @return string
*/
private function connection_label( $service_label, $display_name ) {
return sprintf(
/* translators: %1$s: Service Name (Facebook, Twitter, ...), %2$s: Username on Service (@jetpack, ...) */
__( '%1$s: %2$s', 'jetpack-publicize-pkg' ),
$service_label,
$display_name
);
}
/**
* Extracts the connections that require reauthentication, for example, LinkedIn, when it switched v1 to v2 of its API.
*
* @return array Connections that must be reauthenticated
*/
public function get_must_reauth_connections() {
$must_reauth = array();
$connections = $this->publicize->get_connections( 'linkedin' );
if ( is_array( $connections ) ) {
foreach ( $connections as $index => $connection ) {
if ( $this->publicize->is_invalid_linkedin_connection( $connection ) ) {
$must_reauth[ $index ] = 'LinkedIn';
}
}
}
return $must_reauth;
}
/**
* Controls the metabox that is displayed on the post page
* Allows the user to customize the message that will be sent out to the social network, as well as pick which
* networks to publish to. Also displays the character counter and some other information.
*/
public function post_page_metabox() {
global $post;
if ( ! $this->publicize->post_type_is_publicizeable( $post->post_type ) ) {
return;
}
$connections_data = $this->publicize->get_filtered_connection_data();
$available_services = $this->publicize->get_services( 'all' );
if ( ! is_array( $available_services ) ) {
$available_services = array();
}
if ( ! is_array( $connections_data ) ) {
$connections_data = array();
}
?>
<div id="publicize" class="misc-pub-section misc-pub-section-last">
<span id="publicize-title">
<?php
esc_html_e( 'Jetpack Social:', 'jetpack-publicize-pkg' );
if ( ! empty( $connections_data ) ) :
$publicize_form = $this->get_metabox_form_connected( $connections_data );
$must_reauth = $this->get_must_reauth_connections();
if ( ! empty( $must_reauth ) ) {
foreach ( $must_reauth as $connection_name ) {
?>
<span class="notice-warning publicize__notice-warning">
<?php
printf(
/* translators: %s is the name of a Jetpack Social service like "LinkedIn" */
esc_html__(
'Your %s connection needs to be reauthenticated to continue working – head to Sharing to take care of it.',
'jetpack-publicize-pkg'
),
$connection_name // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
);
?>
<a
class="publicize-external-link"
href="<?php echo esc_url( $this->publicize->publicize_connections_url() ); ?>"
target="_blank"
>
<span class="publicize-external-link__text"><?php esc_html_e( 'Go to Sharing settings', 'jetpack-publicize-pkg' ); ?></span>
<span class="dashicons dashicons-external"></span>
</a>
</span>
<?php
}
}
$labels = array();
foreach ( $connections_data as $connection_data ) {
if ( ! $connection_data['enabled'] || ( isset( $connection_data['is_healthy'] ) && false === $connection_data['is_healthy'] ) ) {
continue;
}
$labels[] = sprintf(
'<strong>%s</strong>',
esc_html( $this->connection_label( $connection_data['service_label'], $connection_data['display_name'] ) )
);
}
?>
<?php // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- labels are already escaped above ?>
<span id="publicize-defaults"><?php echo join( ', ', $labels ); ?></span>
<a href="#" id="publicize-form-edit"><?php esc_html_e( 'Edit', 'jetpack-publicize-pkg' ); ?></a> <a href="<?php echo esc_url( $this->publicize->publicize_connections_url( 'jetpack-social-connections-classic-editor' ) ); ?>" rel="noopener noreferrer" target="_blank"><?php esc_html_e( 'Settings', 'jetpack-publicize-pkg' ); ?></a><br />
<?php
else :
$publicize_form = $this->get_metabox_form_disconnected( $available_services );
?>
<strong><?php esc_html_e( 'Not Connected', 'jetpack-publicize-pkg' ); ?></strong>
<a href="<?php echo esc_url( $this->publicize->publicize_connections_url( 'jetpack-social-connections-classic-editor' ) ); ?>" rel="noopener noreferrer" target="_blank"><?php esc_html_e( 'Settings', 'jetpack-publicize-pkg' ); ?></a><br />
<?php
endif;
?>
</span>
<?php
/**
* Fires right before rendering the Publicize form in the Classic
* Editor.
*
* @since 0.14.0
*/
do_action( 'publicize_classic_editor_form_before' );
/**
* Filter the Publicize details form.
*
* @since 0.1.0
* @since-jetpack 2.0.0
*
* @param string $publicize_form Publicize Details form appearing above Publish button in the editor.
*/
echo apply_filters( 'publicize_form', $publicize_form ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Parts of the form are escaped individually in the code above.
/**
* Fires right after rendering the Publicize form in the Classic
* Editor.
*
* @since 0.14.0
*/
do_action( 'publicize_classic_editor_form_after' );
?>
</div>
<?php
}
/**
* Generates HTML content for connections form.
*
* @since 0.1.0
* @since-jetpack 6.7.0
*
* @global WP_Post $post The current post instance being published.
*
* @param array $connections_data Array of connections.
* @return array {
* Array of content for generating connection form.
*
* @type string HTML content of form
* @type array {
* Array of connection labels for active connections only.
*
* @type string Connection label string.
* }
* }
*/
private function get_metabox_form_connected( $connections_data ) {
global $post;
$all_done = $this->publicize->post_is_done_sharing();
$all_connections_done = true;
$broken_connections = array();
ob_start();
?>
<div id="publicize-form" class="hide-if-js">
<ul>
<?php
foreach ( $connections_data as $connection_data ) {
$all_connections_done = $all_connections_done && $connection_data['done'];
$connection_healthy = ! isset( $connection_data['is_healthy'] ) || $connection_data['is_healthy'];
if ( ! $connection_healthy ) {
$broken_connections[] = $connection_data;
}
?>
<li>
<label
for="wpas-submit-<?php echo esc_attr( $connection_data['unique_id'] ); ?>"
<?php echo ! $connection_data['toggleable'] ? 'class="wpas-disabled"' : ''; ?>
>
<input
type="checkbox"
name="wpas[submit][<?php echo esc_attr( $connection_data['unique_id'] ); ?>]"
id="wpas-submit-<?php echo esc_attr( $connection_data['unique_id'] ); ?>"
class="wpas-submit-<?php echo esc_attr( $connection_data['service_name'] ); ?>"
value="1"
<?php
checked( true, $connection_data['enabled'] && $connection_healthy );
disabled( false, $connection_data['toggleable'] && $connection_healthy );
?>
/>
<?php if ( $connection_data['enabled'] && $connection_healthy && ! $connection_data['toggleable'] ) : // Need to submit a value to force a global connection to POST. ?>
<input
type="hidden"
name="wpas[submit][<?php echo esc_attr( $connection_data['unique_id'] ); ?>]"
value="1"
/>
<?php endif; ?>
<?php echo esc_html( $this->connection_label( $connection_data['service_label'], $connection_data['display_name'] ) ); ?>
</label>
</li>
<?php
}
$title = get_post_meta( $post->ID, $this->publicize->POST_MESS, true );
if ( ! $title ) {
$title = '';
}
$all_done = $all_done || $all_connections_done;
?>
</ul>
<label for="wpas-title"><?php esc_html_e( 'Custom Message:', 'jetpack-publicize-pkg' ); ?></label>
<span id="wpas-title-counter" class="alignright hide-if-no-js">0</span>
<textarea name="wpas_title" id="wpas-title"<?php disabled( $all_done ); ?>><?php echo esc_textarea( $title ); ?></textarea>
<a href="#" class="hide-if-no-js button" id="publicize-form-hide"><?php esc_html_e( 'OK', 'jetpack-publicize-pkg' ); ?></a>
<input type="hidden" name="wpas[0]" value="1" />
</div>
<?php if ( ! $all_done ) : ?>
<?php if ( $broken_connections ) : ?>
<div id="pub-connection-tests" class="error below-h2 publicize-token-refresh-message">
<?php
printf(
wp_kses(
/* translators: %s is the link to the connections page in Calypso */
_n(
'One of your social connections is broken. Reconnect it on the <a href="%s" rel="noopener noreferrer" target="_blank">connection management</a> page.',
'Some of your social connections are broken. Reconnect them on the <a href="%s" rel="noopener noreferrer" target="_blank">connection management</a> page.',
count( $broken_connections ),
'jetpack-publicize-pkg'
),
array(
'a' => array(
'href' => array(),
'target' => array(),
'rel' => array(),
),
)
),
esc_url( $this->publicize->publicize_connections_url() )
);
?>
</div>
<?php else : ?>
<div id="pub-connection-tests"></div>
<?php endif; ?>
<?php endif; ?>
<?php
return ob_get_clean();
}
/**
* Metabox that is shown when no services are connected.
*
* @param array $available_services Array of available services for connecting.
*/
private function get_metabox_form_disconnected( $available_services ) {
ob_start();
?>
<div id="publicize-form" class="hide-if-js">
<div id="add-publicize-check" style="display: none;"></div>
<?php esc_html_e( 'Connect to', 'jetpack-publicize-pkg' ); ?>:
<ul class="not-connected">
<?php foreach ( $available_services as $service_name => $service ) : ?>
<li>
<?php /* translators: %s is the name of a Publicize service such as "LinkedIn" */ ?>
<a class="pub-service" data-service="<?php echo esc_attr( $service_name ); ?>" title="<?php echo esc_attr( sprintf( __( 'Connect and share your posts on %s', 'jetpack-publicize-pkg' ), $this->publicize->get_service_label( $service_name ) ) ); ?>" rel="noopener noreferrer" target="_blank" href="<?php echo esc_url( $this->publicize->connect_url( $service_name ) ); ?>">
<?php echo esc_html( $this->publicize->get_service_label( $service_name ) ); ?>
</a>
</li>
<?php endforeach; ?>
</ul>
<a href="#" class="hide-if-no-js button" id="publicize-disconnected-form-hide"><?php esc_html_e( 'OK', 'jetpack-publicize-pkg' ); ?></a>
</div>
<?php
return ob_get_clean();
}
}