334 lines
11 KiB
PHP
334 lines
11 KiB
PHP
<?php
|
|
// Copyright 2026 Umbra Tools (umbratools.com)
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
/**
|
|
* Widgets
|
|
*
|
|
* @package BD_Murphy
|
|
*/
|
|
|
|
if (!defined('ABSPATH')) {
|
|
exit;
|
|
}
|
|
|
|
/**
|
|
* Goodreads Books Widget
|
|
* Fetches books from Goodreads author page and displays them.
|
|
*/
|
|
class BDM_Goodreads_Books_Widget extends WP_Widget {
|
|
|
|
public function __construct() {
|
|
parent::__construct(
|
|
'bdm_goodreads_books',
|
|
esc_html__('GoodReads Books', 'bd-bookshelf'),
|
|
array(
|
|
'description' => esc_html__('Display author books from Goodreads with ratings', 'bd-bookshelf'),
|
|
'classname' => 'widget-goodreads-books',
|
|
)
|
|
);
|
|
}
|
|
|
|
public function widget($args, $instance) {
|
|
echo $args['before_widget'];
|
|
|
|
$author_name = get_theme_mod('author_name', 'B.D. Murphy');
|
|
$title = sprintf(esc_html__('GoodReads for %s', 'bd-bookshelf'), $author_name);
|
|
|
|
if (!empty($instance['title'])) {
|
|
$title = $instance['title'];
|
|
}
|
|
|
|
if (!empty($title)) {
|
|
echo $args['before_title'] . esc_html($title) . $args['after_title'];
|
|
}
|
|
|
|
// Try to get books from BD_BookShelfHelper first
|
|
$books = array();
|
|
if (class_exists('BD_BookShelfHelper')) {
|
|
$query = new WP_Query(array(
|
|
'post_type' => 'book',
|
|
'posts_per_page' => -1,
|
|
'post_status' => 'publish',
|
|
'orderby' => 'date',
|
|
'order' => 'DESC',
|
|
));
|
|
$books = $query->posts;
|
|
}
|
|
|
|
if (!empty($books)) {
|
|
echo '<div class="goodreads-books-list">';
|
|
foreach ($books as $book) {
|
|
$this->render_book_item($book);
|
|
}
|
|
echo '</div>';
|
|
} else {
|
|
// Fallback: fetch from Goodreads author page
|
|
$this->render_goodreads_fallback();
|
|
}
|
|
|
|
echo $args['after_widget'];
|
|
}
|
|
|
|
/**
|
|
* Render books by fetching from Goodreads author widget
|
|
*/
|
|
private function render_goodreads_fallback() {
|
|
if (!get_theme_mod('enable_goodreads_fetch', false)) {
|
|
echo '<p class="no-books">' . esc_html__('Goodreads integration is not enabled. Enable it in Customizer > Display Options.', 'bd-bookshelf') . '</p>';
|
|
return;
|
|
}
|
|
|
|
$goodreads_id = get_theme_mod('goodreads_author_id', '30469651');
|
|
|
|
if (empty($goodreads_id)) {
|
|
echo '<p class="no-books">' . esc_html__('Configure your Goodreads Author ID in Theme Settings.', 'bd-bookshelf') . '</p>';
|
|
return;
|
|
}
|
|
|
|
$books = array();
|
|
|
|
// Check transient cache first (24 hours)
|
|
$cache_key = 'bdm_goodreads_books_' . sanitize_title($goodreads_id);
|
|
$cached_books = get_transient($cache_key);
|
|
|
|
if ($cached_books !== false) {
|
|
$books = $cached_books;
|
|
} else {
|
|
$widget_url = sprintf(
|
|
'https://www.goodreads.com/author/list/%s',
|
|
esc_attr($goodreads_id)
|
|
);
|
|
|
|
$response = wp_remote_get($widget_url, array(
|
|
'timeout' => 10,
|
|
'headers' => array(
|
|
'User-Agent' => 'Mozilla/5.0 (compatible; BDBookshelf/1.0)',
|
|
),
|
|
));
|
|
|
|
if (!is_wp_error($response)) {
|
|
$body = wp_remote_retrieve_body($response);
|
|
$books = $this->parse_goodreads_html($body);
|
|
if (!empty($books)) {
|
|
set_transient($cache_key, $books, 24 * HOUR_IN_SECONDS);
|
|
}
|
|
}
|
|
}
|
|
|
|
if (empty($books)) {
|
|
echo '<p class="no-books">' . esc_html__('No books found on Goodreads.', 'bd-bookshelf') . '</p>';
|
|
return;
|
|
}
|
|
|
|
echo '<div class="goodreads-books-list">';
|
|
foreach ($books as $book) {
|
|
echo '<div class="goodreads-book-item">';
|
|
|
|
if (!empty($book['cover'])) {
|
|
printf(
|
|
'<div class="goodreads-book-cover"><img src="%s" alt="%s" loading="lazy"></div>',
|
|
esc_url($book['cover']),
|
|
esc_attr($book['title'])
|
|
);
|
|
}
|
|
|
|
echo '<div class="goodreads-book-details">';
|
|
|
|
if (!empty($book['url'])) {
|
|
printf(
|
|
'<a href="%s" class="goodreads-book-title" target="_blank" rel="noopener noreferrer">%s</a>',
|
|
esc_url($book['url']),
|
|
esc_html($book['title'])
|
|
);
|
|
} else {
|
|
printf(
|
|
'<span class="goodreads-book-title">%s</span>',
|
|
esc_html($book['title'])
|
|
);
|
|
}
|
|
|
|
if (!empty($book['rating'])) {
|
|
printf(
|
|
'<div class="goodreads-book-ratings"><span class="rating goodreads"> Goodreads: %s/5</span></div>',
|
|
esc_html($book['rating'])
|
|
);
|
|
}
|
|
|
|
echo '</div></div>';
|
|
}
|
|
echo '</div>';
|
|
}
|
|
|
|
/**
|
|
* Parse Goodreads author page HTML for books
|
|
* Version 2.2.1 - Top 6 books by rating
|
|
*/
|
|
private function parse_goodreads_html($html) {
|
|
$books = array();
|
|
|
|
// Use DOMDocument to parse
|
|
$dom = new DOMDocument();
|
|
libxml_use_internal_errors(true);
|
|
$dom->loadHTML('<?xml encoding="UTF-8">' . $html);
|
|
libxml_clear_errors();
|
|
|
|
$xpath = new DOMXPath($dom);
|
|
|
|
// Find book rows - Goodreads uses table rows for book lists
|
|
$rows = $xpath->query('//tr[itemtype="http://schema.org/Book"]');
|
|
|
|
if ($rows->length === 0) {
|
|
// Try alternative selectors
|
|
$rows = $xpath->query('//tr');
|
|
}
|
|
|
|
foreach ($rows as $row) {
|
|
$title = '';
|
|
$cover = '';
|
|
$url = '';
|
|
$rating = '';
|
|
|
|
// Get title
|
|
$titleNodes = $xpath->query('.//a[@class="bookTitle"]', $row);
|
|
if ($titleNodes->length > 0) {
|
|
$title = trim($titleNodes->item(0)->textContent);
|
|
$url = $titleNodes->item(0)->getAttribute('href');
|
|
if ($url && strpos($url, 'http') !== 0) {
|
|
$url = 'https://www.goodreads.com' . $url;
|
|
}
|
|
}
|
|
|
|
if (empty($title)) continue;
|
|
|
|
// Get cover image
|
|
$imgNodes = $xpath->query('.//img', $row);
|
|
if ($imgNodes->length > 0) {
|
|
$cover = $imgNodes->item(0)->getAttribute('src');
|
|
}
|
|
|
|
// Get rating and review count
|
|
$ratingNodes = $xpath->query('.//span[@class="minirating"]', $row);
|
|
if ($ratingNodes->length > 0) {
|
|
$rating_text = $ratingNodes->item(0)->textContent;
|
|
if (preg_match('/([\d.]+)\s*avg/', $rating_text, $matches)) {
|
|
$rating = $matches[1];
|
|
}
|
|
if (preg_match('/([\d,]+)\s*rating/', $rating_text, $matches)) {
|
|
$review_count = intval(str_replace(',', '', $matches[1]));
|
|
}
|
|
}
|
|
|
|
if (!empty($title)) {
|
|
$books[] = array(
|
|
'title' => $title,
|
|
'cover' => $cover,
|
|
'url' => $url,
|
|
'rating' => $rating,
|
|
'review_count' => $review_count,
|
|
);
|
|
}
|
|
}
|
|
|
|
// Sort by review count descending (most reviews first)
|
|
usort($books, function($a, $b) {
|
|
$countA = intval($a['review_count']);
|
|
$countB = intval($b['review_count']);
|
|
if ($countA == $countB) return 0;
|
|
return ($countA > $countB) ? -1 : 1;
|
|
});
|
|
|
|
// Return top 6
|
|
return array_slice($books, 0, 6);
|
|
}
|
|
|
|
private function render_book_item($book) {
|
|
$cover_url = '';
|
|
if (has_post_thumbnail($book->ID)) {
|
|
$cover_url = get_the_post_thumbnail_url($book->ID, 'shelf-thumb');
|
|
}
|
|
|
|
$title = $book->post_title;
|
|
$slug = get_post_meta($book->ID, 'short_link_slug', true);
|
|
$url = $slug ? home_url('/' . $slug) : get_permalink($book->ID);
|
|
|
|
$ratings = array();
|
|
$amazon = get_post_meta($book->ID, 'amazon_rating', true);
|
|
$goodreads = get_post_meta($book->ID, 'goodreads_rating', true);
|
|
if ($amazon) $ratings['amazon'] = $amazon;
|
|
if ($goodreads) $ratings['goodreads'] = $goodreads;
|
|
|
|
echo '<div class="goodreads-book-item">';
|
|
|
|
if ($cover_url) {
|
|
printf(
|
|
'<div class="goodreads-book-cover"><a href="%s"><img src="%s" alt="%s"></a></div>',
|
|
esc_url($url),
|
|
esc_url($cover_url),
|
|
esc_attr($title)
|
|
);
|
|
}
|
|
|
|
echo '<div class="goodreads-book-details">';
|
|
printf(
|
|
'<a href="%s" class="goodreads-book-title">%s</a>',
|
|
esc_url($url),
|
|
esc_html($title)
|
|
);
|
|
|
|
if (!empty($ratings)) {
|
|
echo '<div class="goodreads-book-ratings">';
|
|
if (!empty($ratings['amazon'])) {
|
|
printf('<span class="rating amazon">Amazon: %s/5</span> ', esc_html($ratings['amazon']));
|
|
}
|
|
if (!empty($ratings['goodreads'])) {
|
|
printf('<span class="rating goodreads">Goodreads: %s/5</span>', esc_html($ratings['goodreads']));
|
|
}
|
|
echo '</div>';
|
|
}
|
|
|
|
echo '</div></div>';
|
|
}
|
|
|
|
public function form($instance) {
|
|
$title = !empty($instance['title']) ? $instance['title'] : '';
|
|
$author_name = get_theme_mod('author_name', 'B.D. Murphy');
|
|
$goodreads_id = get_theme_mod('goodreads_author_id', '30469651');
|
|
?>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('title')); ?>">
|
|
<?php esc_html_e('Title:', 'bd-bookshelf'); ?>
|
|
</label>
|
|
<input class="widefat" id="<?php echo esc_attr($this->get_field_id('title')); ?>"
|
|
name="<?php echo esc_attr($this->get_field_name('title')); ?>"
|
|
type="text" value="<?php echo esc_attr($title); ?>">
|
|
</p>
|
|
<p>
|
|
<small>
|
|
<?php
|
|
printf(
|
|
esc_html__('Author: %s | Goodreads ID: %s', 'bd-bookshelf'),
|
|
esc_html($author_name),
|
|
esc_html($goodreads_id)
|
|
);
|
|
?>
|
|
</small><br>
|
|
<a href="<?php echo esc_url(admin_url('customize.php?autofocus[section]=bdm_book_settings')); ?>" target="_blank">
|
|
<?php esc_html_e('Edit in Theme Settings', 'bd-bookshelf'); ?>
|
|
</a>
|
|
</p>
|
|
<?php
|
|
}
|
|
|
|
public function update($new_instance, $old_instance) {
|
|
$instance = array();
|
|
$instance['title'] = sanitize_text_field($new_instance['title']);
|
|
return $instance;
|
|
}
|
|
}
|
|
|
|
function bdm_register_widgets() {
|
|
register_widget('BDM_Goodreads_Books_Widget');
|
|
}
|
|
add_action('widgets_init', 'bdm_register_widgets');
|