'Recommended_Widget parsely-recommended-widget-hidden',
'description' => __( 'Display a list of post recommendations, personalized for a visitor or the current post.', 'wp-parsely' ),
)
);
}
/**
* Get the URL for the Recommendation API (GET /related).
*
* @see https://www.parse.ly/help/api/recommendations#get-related
*
* @internal While this is a public method now, this should be moved to a new class.
*
* @since 2.5.0
*
* @param string $api_key Publisher Site ID (API key).
* @param int $published_within Publication filter start date; see https://www.parse.ly/help/api/time for
* formatting details. No restriction by default.
* @param string $sort What to sort the results by. There are currently 2 valid options: `score`, which
* will sort articles by overall relevance and `pub_date` which will sort results by
* their publication date. The default is `score`.
* @param string $boost Available for sort=score only. Sub-sort value to re-rank relevant posts that
* received high e.g. views; default is undefined.
* @param int $return_limit Number of records to retrieve; defaults to "10".
* @return string API URL.
*/
private function get_api_url( string $api_key, int $published_within, string $sort, string $boost, int $return_limit ): string {
$related_api_endpoint = 'https://api.parsely.com/v2/related';
$query_args = array(
'apikey' => $api_key,
'sort' => $sort,
'limit' => $return_limit,
);
if ( 'score' === $sort && 'no-boost' !== $boost ) {
$query_args['boost'] = $boost;
}
if ( 0 !== $published_within ) {
$query_args['pub_date_start'] = $published_within . 'd';
}
return add_query_arg( $query_args, $related_api_endpoint );
}
/**
* This is the widget function
*
* @param array $args Widget Arguments.
* @param array $instance Values saved to the db.
* @return void
*/
public function widget( $args, $instance ): void {
if ( ! $this->api_key_and_secret_are_populated() ) {
return;
}
$removed_title_esc = remove_filter( 'widget_title', 'esc_html' );
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$title = apply_filters( 'widget_title', $instance['title'] );
if ( $removed_title_esc ) {
add_filter( 'widget_title', 'esc_html' );
}
wp_enqueue_style( 'wp-parsely-style' );
$title_html = $args['before_widget'] . $args['before_title'] . $title . $args['after_title'];
echo wp_kses_post( $title_html );
// Set up the variables.
$options = get_option( 'parsely' );
$api_url = $this->get_api_url(
$options['apikey'],
$instance['published_within'],
$instance['sort'],
$instance['boost'],
(int) $instance['return_limit']
);
$recommended_widget_script_asset = require plugin_dir_path( PARSELY_FILE ) . 'build/admin-page.asset.php';
?>
migrate_old_fields( $instance );
if ( ! $this->api_key_and_secret_are_populated() ) {
$settings_page_url = add_query_arg( 'page', 'parsely', get_admin_url() . 'options-general.php' );
$message = sprintf(
/* translators: %s: Plugin settings page URL */
__( 'The Parse.ly Site ID and Parse.ly API Secret fields need to be populated on the Parse.ly settings page for this widget to work.', 'wp-parsely' ),
esc_url( $settings_page_url )
);
echo '