feat(widgets): zibll-like in_affix sticky option across side modules

Add sidebar affix (data-affix) to ranking, user/author cards, main/hot/
paid/forum lists, comments, tag cloud, categories and text title with
shared sticky CSS.

assets/css/frontend/widget-batch5.css

@@ -2552,3 +2552,16 @@ a.main-color > .icon-cover-card:hover,
   display: inline-block; margin-top: 4px; padding: 1px 6px; border-radius: 4px;
   background: rgba(240,68,148,.1); color: var(--theme-color, #f04494); font-size: 12px;
 }
+
+
+/* batch46-48 residual */
+.widget .is-affix[data-affix="true"],
+.ajaxpager.is-affix[data-affix="true"],
+.zib-widget.is-affix[data-affix="true"],
+.aksrt-author-card.is-affix[data-affix="true"],
+.aksrt-text-title.is-affix[data-affix="true"] {
+  position: sticky;
+  top: 72px;
+  z-index: 2;
+}
+.avatar-img.link-img img.aksrt-lazy { object-fit: cover; }

src/AKSRT/Widgets/CategoriesWidget.php

@@ -176,7 +176,14 @@ class CategoriesWidget extends \WP_Widget {
 		if ($title !== '') {
 			echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		}
+		$in_affix = !empty($instance['in_affix']);
+		if ($in_affix) {
+			echo '<div class="is-affix" data-affix="true">';
+		}
 		echo self::render_html($instance); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+		if ($in_affix) {
+			echo '</div>';
+		}
 		echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 	}
 
@@ -231,6 +238,9 @@ class CategoriesWidget extends \WP_Widget {
 			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('hide_empty')); ?>" value="1" <?php checked(!isset($instance['hide_empty']) || !empty($instance['hide_empty'])); ?>> <?php esc_html_e('隐藏空分类', 'aksrt'); ?></label><br>
 			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('hierarchical')); ?>" value="1" <?php checked(!empty($instance['hierarchical'])); ?>> <?php esc_html_e('层级树', 'aksrt'); ?></label>
 		</p>
+		<p>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('in_affix')); ?>" value="1" <?php checked(!empty($instance['in_affix'])); ?>> <?php esc_html_e('侧栏随动', 'aksrt'); ?></label>
+		</p>
 		<?php
 	}
 
@@ -257,6 +267,7 @@ class CategoriesWidget extends \WP_Widget {
 			'show_thumb'   => !empty($new_instance['show_thumb']) ? 1 : 0,
 			'hide_empty'   => !empty($new_instance['hide_empty']) ? 1 : 0,
 			'hierarchical' => !empty($new_instance['hierarchical']) ? 1 : 0,
+			'in_affix' => !empty($new_instance['in_affix']) ? 1 : 0,
 		];
 	}
 }

src/AKSRT/Widgets/HotPostsWidget.php

@@ -204,10 +204,12 @@ class HotPostsWidget extends \WP_Widget {
 		if ($title) {
 			echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		}
+		$in_affix = !empty($instance['in_affix']);
 		$instance['paginate'] = sanitize_key((string) ($instance['paginate'] ?? 'ajax'));
 		$payload = self::query_payload($instance, 1);
 		$rest = rest_url('aksrt/v1/widgets/hot-posts');
-		echo '<div class="ajaxpager" data-aksrt-ajaxpager data-aksrt-ajax-url="' . esc_url($rest) . '">';
+		$wrap = 'ajaxpager' . ($in_affix ? ' is-affix' : '');
+		echo '<div class="' . esc_attr($wrap) . '" data-aksrt-ajaxpager data-aksrt-ajax-url="' . esc_url($rest) . '"' . ($in_affix ? ' data-affix="true"' : '') . '>';
 		echo $payload['html']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		echo $payload['paginate_html']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		echo '<div class="post_ajax_loader" data-aksrt-ajax-loader data-aksrt-ajax-loader-hide hidden></div>';
@@ -244,7 +246,8 @@ class HotPostsWidget extends \WP_Widget {
 			<input class="tiny-text" id="<?php echo esc_attr($this->get_field_id('days')); ?>" name="<?php echo esc_attr($this->get_field_name('days')); ?>" type="number" min="0" max="365" value="<?php echo (int) $days; ?>">
 		</p>
 		<p>
-			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('show_thumb')); ?>" value="1" <?php checked(!empty($instance['show_thumb'])); ?>> <?php esc_html_e('显示缩略图', 'aksrt'); ?></label>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('show_thumb')); ?>" value="1" <?php checked(!empty($instance['show_thumb'])); ?>> <?php esc_html_e('显示缩略图', 'aksrt'); ?></label><br>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('in_affix')); ?>" value="1" <?php checked(!empty($instance['in_affix'])); ?>> <?php esc_html_e('侧栏随动', 'aksrt'); ?></label>
 		</p>
 		<p>
 			<label><?php esc_html_e('分页', 'aksrt'); ?>
@@ -265,6 +268,7 @@ class HotPostsWidget extends \WP_Widget {
 			'order_by'   => in_array($new_instance['order_by'] ?? '', ['views', 'comments', 'likes', 'favorites', 'downloads'], true) ? $new_instance['order_by'] : 'views',
 			'days'       => absint($new_instance['days'] ?? 30),
 			'show_thumb' => !empty($new_instance['show_thumb']) ? 1 : 0,
+			'in_affix'   => !empty($new_instance['in_affix']) ? 1 : 0,
 			'paginate'   => in_array(sanitize_key((string) ($new_instance['paginate'] ?? 'ajax')), ['none', 'ajax', 'number'], true) ? sanitize_key((string) ($new_instance['paginate'] ?? 'ajax')) : 'ajax',
 		];
 	}

src/AKSRT/Widgets/RecentCommentsWidget.php

@@ -169,7 +169,14 @@ class RecentCommentsWidget extends \WP_Widget {
 		if ($title !== '') {
 			echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		}
+		$in_affix = !empty($instance['in_affix']);
+		if ($in_affix) {
+			echo '<div class="is-affix" data-affix="true">';
+		}
 		echo self::render_html($instance); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+		if ($in_affix) {
+			echo '</div>';
+		}
 		echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 	}
 
@@ -202,6 +209,9 @@ class RecentCommentsWidget extends \WP_Widget {
 			</label>
 			<small><?php esc_html_e('填数字 ID 时按作者排除；填文字时按内容关键词排除（兼容旧配置）。', 'aksrt'); ?></small>
 		</p>
+		<p>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('in_affix')); ?>" value="1" <?php checked(!empty($instance['in_affix'])); ?>> <?php esc_html_e('侧栏随动', 'aksrt'); ?></label>
+		</p>
 		<?php
 	}
 

src/AKSRT/Widgets/TagCloudWidget.php

@@ -101,7 +101,14 @@ class TagCloudWidget extends \WP_Widget {
 		if ($title !== '') {
 			echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		}
+		$in_affix = !empty($instance['in_affix']);
+		if ($in_affix) {
+			echo '<div class="is-affix" data-affix="true">';
+		}
 		echo self::render_html($instance); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+		if ($in_affix) {
+			echo '</div>';
+		}
 		echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 	}
 
@@ -154,7 +161,8 @@ class TagCloudWidget extends \WP_Widget {
 			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('blank')); ?>" value="1" <?php checked(!empty($instance['blank'])); ?>> <?php esc_html_e('新窗口', 'aksrt'); ?></label><br>
 			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('fixed_width')); ?>" value="1" <?php checked(!empty($instance['fixed_width'])); ?>> <?php esc_html_e('固定宽度', 'aksrt'); ?></label><br>
 			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('hide_empty')); ?>" value="1" <?php checked(!empty($instance['hide_empty'])); ?>> <?php esc_html_e('隐藏空标签', 'aksrt'); ?></label><br>
-				<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('scale')); ?>" value="1" <?php checked(!empty($instance['scale'])); ?>> <?php esc_html_e('按数量缩放字号', 'aksrt'); ?></label>
+				<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('scale')); ?>" value="1" <?php checked(!empty($instance['scale'])); ?>> <?php esc_html_e('按数量缩放字号', 'aksrt'); ?></label><br>
+				<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('in_affix')); ?>" value="1" <?php checked(!empty($instance['in_affix'])); ?>> <?php esc_html_e('侧栏随动', 'aksrt'); ?></label>
 		</p>
 		<?php
 	}

src/AKSRT/Widgets/WidgetAuthorCard.php

@@ -84,13 +84,15 @@ class WidgetAuthorCard extends \WP_Widget {
 			? aksrt_get_user_name(['id' => $author_id, 'follow' => false, 'class' => 'flex ac jc'])
 			: '<a href="' . esc_url($home) . '">' . esc_html($user->display_name) . '</a>';
 
+		$in_affix = !empty($instance['in_affix']);
 		echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		$title = apply_filters('widget_title', (string) ($instance['title'] ?? ''), $instance, $this->id_base);
 		if ($title !== '') {
 			echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		}
 
-		echo '<div class="aksrt-author-card user-card author zib-widget' . ($show_bg ? ' has-cover' : '') . '">';
+		$card_cls = 'aksrt-author-card user-card author zib-widget' . ($show_bg ? ' has-cover' : '') . ($in_affix ? ' is-affix' : '');
+		echo '<div class="' . esc_attr($card_cls) . '"' . ($in_affix ? ' data-affix="true"' : '') . '>';
 		if ($show_bg) {
 			$bg = $cover !== '' ? ' style="background-image:url(' . esc_url($cover) . ')"' : '';
 			echo '<div class="aksrt-author-card__cover user-cover graphic"' . $bg . '></div>';
@@ -208,6 +210,9 @@ class WidgetAuthorCard extends \WP_Widget {
 				</select>
 			</label>
 		</p>
+		<p>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('in_affix')); ?>" value="1" <?php checked(!empty($instance['in_affix'])); ?>> <?php esc_html_e('侧栏随动', 'aksrt'); ?></label>
+		</p>
 		<?php
 	}
 

src/AKSRT/Widgets/WidgetForumHotTopics.php

@@ -179,7 +179,9 @@ class WidgetForumHotTopics extends \WP_Widget {
 		echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		$rest = rest_url('aksrt/v1/widgets/forum-topics');
-		echo '<div class="ajaxpager" data-aksrt-ajaxpager data-aksrt-ajax-url="' . esc_url($rest) . '">';
+		$in_affix = !empty($instance['in_affix']);
+		$wrap = 'ajaxpager' . ($in_affix ? ' is-affix' : '');
+		echo '<div class="' . esc_attr($wrap) . '" data-aksrt-ajaxpager data-aksrt-ajax-url="' . esc_url($rest) . '"' . ($in_affix ? ' data-affix="true"' : '') . '>';
 		echo $payload['html']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		echo $payload['paginate_html']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		echo '<div class="post_ajax_loader" data-aksrt-ajax-loader data-aksrt-ajax-loader-hide hidden></div>';
@@ -243,6 +245,9 @@ class WidgetForumHotTopics extends \WP_Widget {
 				</select>
 			</label>
 		</p>
+		<p>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('in_affix')); ?>" value="1" <?php checked(!empty($instance['in_affix'])); ?>> <?php esc_html_e('侧栏随动', 'aksrt'); ?></label>
+		</p>
 		<?php
 	}
 

src/AKSRT/Widgets/WidgetForumRecentTopics.php

@@ -40,7 +40,9 @@ class WidgetForumRecentTopics extends \WP_Widget {
 		echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		$rest = rest_url('aksrt/v1/widgets/forum-topics');
-		echo '<div class="ajaxpager" data-aksrt-ajaxpager data-aksrt-ajax-url="' . esc_url($rest) . '">';
+		$in_affix = !empty($instance['in_affix']);
+		$wrap = 'ajaxpager' . ($in_affix ? ' is-affix' : '');
+		echo '<div class="' . esc_attr($wrap) . '" data-aksrt-ajaxpager data-aksrt-ajax-url="' . esc_url($rest) . '"' . ($in_affix ? ' data-affix="true"' : '') . '>';
 		echo $payload['html']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		echo $payload['paginate_html']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		echo '<div class="post_ajax_loader" data-aksrt-ajax-loader data-aksrt-ajax-loader-hide hidden></div>';
@@ -84,6 +86,9 @@ class WidgetForumRecentTopics extends \WP_Widget {
 				</select>
 			</label>
 		</p>
+		<p>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('in_affix')); ?>" value="1" <?php checked(!empty($instance['in_affix'])); ?>> <?php esc_html_e('侧栏随动', 'aksrt'); ?></label>
+		</p>
 		<?php
 	}
 
@@ -98,6 +103,7 @@ class WidgetForumRecentTopics extends \WP_Widget {
 			'plate'    => max(0, (int) ($new_instance['plate'] ?? 0)),
 			'style'    => $style,
 			'paginate' => in_array(sanitize_key((string) ($new_instance['paginate'] ?? 'ajax')), ['none', 'ajax', 'number'], true) ? sanitize_key((string) ($new_instance['paginate'] ?? 'ajax')) : 'ajax',
+			'in_affix'  => !empty($new_instance['in_affix']) ? 1 : 0,
 		];
 	}
 }

src/AKSRT/Widgets/WidgetMainPosts.php

@@ -324,11 +324,15 @@ class WidgetMainPosts extends \WP_Widget {
 		], static function ($v) {
 			return $v !== '' && $v !== null;
 		}));
+		$in_affix = !empty($instance['in_affix']);
 		$wrap_cls = 'aksrt-main-posts style-' . $style . ' ajaxpager';
 		if ($style === 'mini') {
 			$wrap_cls .= ' zib-widget posts-mini-lists';
 		}
-		echo '<div class="' . esc_attr($wrap_cls) . '" data-aksrt-ajaxpager data-aksrt-ajax-url="' . esc_url($rest) . '" data-load-mode="' . esc_attr($load_mode) . '" data-query="' . esc_attr($qs) . '"' . ($load_mode === 'ajax' ? ' data-loaded="0"' : ' data-loaded="1"') . '>';
+		if ($in_affix) {
+			$wrap_cls .= ' is-affix';
+		}
+		echo '<div class="' . esc_attr($wrap_cls) . '" data-aksrt-ajaxpager data-aksrt-ajax-url="' . esc_url($rest) . '" data-load-mode="' . esc_attr($load_mode) . '" data-query="' . esc_attr($qs) . '"' . ($load_mode === 'ajax' ? ' data-loaded="0"' : ' data-loaded="1"') . ($in_affix ? ' data-affix="true"' : '') . '>';
 
 		if ($load_mode === 'ajax') {
 			// Skeleton first paint (zibll load_mode=ajax).
@@ -435,7 +439,8 @@ class WidgetMainPosts extends \WP_Widget {
 		<p>
 			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('show_thumb')); ?>" value="1" <?php checked(!isset($instance['show_thumb']) || !empty($instance['show_thumb'])); ?>> <?php esc_html_e('显示缩略图', 'aksrt'); ?></label><br>
 			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('show_meta')); ?>" value="1" <?php checked(!isset($instance['show_meta']) || !empty($instance['show_meta'])); ?>> <?php esc_html_e('显示 meta', 'aksrt'); ?></label><br>
-			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('show_number')); ?>" value="1" <?php checked(!empty($instance['show_number'])); ?>> <?php esc_html_e('显示序号', 'aksrt'); ?></label>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('show_number')); ?>" value="1" <?php checked(!empty($instance['show_number'])); ?>> <?php esc_html_e('显示序号', 'aksrt'); ?></label><br>
+				<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('in_affix')); ?>" value="1" <?php checked(!empty($instance['in_affix'])); ?>> <?php esc_html_e('侧栏随动', 'aksrt'); ?></label>
 		</p>
 		<?php
 	}
@@ -467,6 +472,7 @@ class WidgetMainPosts extends \WP_Widget {
 			'show_thumb'  => !empty($new_instance['show_thumb']) ? 1 : 0,
 			'show_meta'   => !empty($new_instance['show_meta']) ? 1 : 0,
 			'show_number' => !empty($new_instance['show_number']) ? 1 : 0,
+			'in_affix'    => !empty($new_instance['in_affix']) ? 1 : 0,
 		];
 	}
 }

src/AKSRT/Widgets/WidgetPaidPosts.php

@@ -187,8 +187,10 @@ class WidgetPaidPosts extends \WP_Widget {
 			echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		}
 
+		$in_affix = !empty($instance['in_affix']);
 		$rest = rest_url('aksrt/v1/widgets/paid-posts');
-		echo '<div class="aksrt-paid-posts-wrap ajaxpager" data-aksrt-ajaxpager data-aksrt-ajax-url="' . esc_url($rest) . '">';
+		$wrap = 'aksrt-paid-posts-wrap ajaxpager' . ($in_affix ? ' is-affix' : '');
+		echo '<div class="' . esc_attr($wrap) . '" data-aksrt-ajaxpager data-aksrt-ajax-url="' . esc_url($rest) . '"' . ($in_affix ? ' data-affix="true"' : '') . '>';
 		echo $payload['html']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		echo $payload['paginate_html']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		echo '<div class="post_ajax_loader" data-aksrt-ajax-loader data-aksrt-ajax-loader-hide hidden></div>';
@@ -246,6 +248,9 @@ class WidgetPaidPosts extends \WP_Widget {
 				<input class="tiny-text" type="number" min="0" name="<?php echo esc_attr($this->get_field_name('limit_day')); ?>" value="<?php echo esc_attr((string) ((int) ($instance['limit_day'] ?? 0))); ?>">
 			</label>
 		</p>
+		<p>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('in_affix')); ?>" value="1" <?php checked(!empty($instance['in_affix'])); ?>> <?php esc_html_e('侧栏随动', 'aksrt'); ?></label>
+		</p>
 		<?php
 	}
 

src/AKSRT/Widgets/WidgetTextTitle.php

@@ -30,6 +30,13 @@ class WidgetTextTitle extends \WP_Widget {
 		$title = trim((string) ($instance['title'] ?? ''));
 		$desc  = trim((string) ($instance['desc'] ?? ''));
 		if ($title === '' && $desc === '') {
+			if (current_user_can('manage_options')) {
+				echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+				echo function_exists('aksrt_get_widget_null')
+					? aksrt_get_widget_null(__('请填写标题或描述', 'aksrt')) // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+					: '<p class="widget-empty">' . esc_html__('请填写标题或描述', 'aksrt') . '</p>';
+				echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+			}
 			return;
 		}
 
@@ -101,7 +108,9 @@ class WidgetTextTitle extends \WP_Widget {
 			}
 		}
 
-		echo '<div class="aksrt-text-title text-title align-' . esc_attr($align) . '" style="' . esc_attr($style) . '">';
+		$in_affix = !empty($instance['in_affix']);
+		$box = 'aksrt-text-title text-title align-' . esc_attr($align) . ($in_affix ? ' is-affix' : '');
+		echo '<div class="' . esc_attr($box) . '" style="' . esc_attr($style) . '"' . ($in_affix ? ' data-affix="true"' : '') . '>';
 		if ($title_html !== '') {
 			echo '<div class="aksrt-text-title__main">' . $title_html . '</div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		}
@@ -173,6 +182,9 @@ class WidgetTextTitle extends \WP_Widget {
 				<input class="widefat" type="text" name="<?php echo esc_attr($this->get_field_name('desc_color')); ?>" value="<?php echo esc_attr((string) ($instance['desc_color'] ?? '')); ?>">
 			</label>
 		</p>
+		<p>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('in_affix')); ?>" value="1" <?php checked(!empty($instance['in_affix'])); ?>> <?php esc_html_e('侧栏随动', 'aksrt'); ?></label>
+		</p>
 		<?php
 	}
 

src/AKSRT/Widgets/WidgetUserCard.php

@@ -27,6 +27,7 @@ class WidgetUserCard extends \WP_Widget {
 		// zibll user widget forces show_posts=false; author widget enables it.
 		// AKSRT keeps optional show_posts for current-user card (default off).
 		$show_posts = !empty($instance['show_posts']);
+		$in_affix = !empty($instance['in_affix']);
 		$loged_title  = (string) ($instance['loged_title'] ?? __('Hi！请登录', 'aksrt'));
 		$btn1_text    = (string) ($instance['button_1_text'] ?? __('发布文章', 'aksrt'));
 		$btn2_text    = (string) ($instance['button_2_text'] ?? __('用户中心', 'aksrt'));
@@ -48,9 +49,15 @@ class WidgetUserCard extends \WP_Widget {
 		if ($title !== '') {
 			echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		}
+		if ($in_affix) {
+			echo '<div class="is-affix" data-affix="true">';
+		}
 
 		if ($user_id <= 0) {
 			$this->render_guest($show_cover, $loged_title);
+			if ($in_affix) {
+				echo '</div>';
+			}
 			echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 			return;
 		}
@@ -249,7 +256,8 @@ class WidgetUserCard extends \WP_Widget {
 			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('show_stats')); ?>" value="1" <?php checked(!isset($instance['show_stats']) || !empty($instance['show_stats'])); ?>> <?php esc_html_e('显示统计', 'aksrt'); ?></label><br>
 			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('show_button')); ?>" value="1" <?php checked(!isset($instance['show_button']) || !empty($instance['show_button'])); ?>> <?php esc_html_e('显示操作按钮', 'aksrt'); ?></label><br>
 			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('show_checkin')); ?>" value="1" <?php checked(!isset($instance['show_checkin']) || !empty($instance['show_checkin'])); ?>> <?php esc_html_e('显示签到（本人）', 'aksrt'); ?></label><br>
-			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('show_posts')); ?>" value="1" <?php checked(!empty($instance['show_posts'])); ?>> <?php esc_html_e('显示更多文章', 'aksrt'); ?></label>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('show_posts')); ?>" value="1" <?php checked(!empty($instance['show_posts'])); ?>> <?php esc_html_e('显示更多文章', 'aksrt'); ?></label><br>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('in_affix')); ?>" value="1" <?php checked(!empty($instance['in_affix'])); ?>> <?php esc_html_e('侧栏随动', 'aksrt'); ?></label>
 		</p>
 		<p>
 			<label><?php esc_html_e('文章数量', 'aksrt'); ?>
@@ -297,6 +305,7 @@ class WidgetUserCard extends \WP_Widget {
 			'show_button'   => !empty($new_instance['show_button']) ? 1 : 0,
 			'show_checkin'  => !empty($new_instance['show_checkin']) ? 1 : 0,
 			'show_posts'    => !empty($new_instance['show_posts']) ? 1 : 0,
+			'in_affix'      => !empty($new_instance['in_affix']) ? 1 : 0,
 			'limit'         => max(0, min(12, (int) ($new_instance['limit'] ?? 6))),
 			'post_style'    => $post_style,
 			'orderby'       => $orderby,

src/AKSRT/Widgets/WidgetUserRanking.php

@@ -29,12 +29,14 @@ class WidgetUserRanking extends \WP_Widget {
 		$show_avatar = !isset($instance['show_avatar']) || !empty($instance['show_avatar']);
 		$desc_mode   = sanitize_key((string) ($instance['desc'] ?? 'desc'));
 		$top_badge   = !empty($instance['top_badge']);
+		$in_affix    = !empty($instance['in_affix']);
 		$users       = $this->get_ranking($rank_by, $count, $desc_mode);
 
 		echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 
-		echo '<div class="zib-widget user-ranking-box aksrt-user-ranking-box">';
+		$box_cls = 'zib-widget user-ranking-box aksrt-user-ranking-box' . ($in_affix ? ' is-affix' : '');
+		echo '<div class="' . esc_attr($box_cls) . '"' . ($in_affix ? ' data-affix="true"' : '') . '>';
 		if (!empty($instance['checkin_btn']) && is_user_logged_in() && function_exists('aksrt_header_user_checkin_btn')) {
 			$cbtn = aksrt_header_user_checkin_btn(get_current_user_id());
 			if ($cbtn !== '') {
@@ -336,6 +338,12 @@ class WidgetUserRanking extends \WP_Widget {
 				<?php esc_html_e('前三名 TOP 角标', 'aksrt'); ?>
 			</label>
 		</p>
+		<p>
+			<label>
+				<input type="checkbox" name="<?php echo esc_attr($this->get_field_name('in_affix')); ?>" value="1" <?php checked(!empty($instance['in_affix'])); ?>>
+				<?php esc_html_e('侧栏随动', 'aksrt'); ?>
+			</label>
+		</p>
 		<?php
 	}
 
@@ -348,6 +356,7 @@ class WidgetUserRanking extends \WP_Widget {
 		$instance['checkin_btn'] = !empty($new_instance['checkin_btn']) ? 1 : 0;
 		$instance['top_badge'] = !empty($new_instance['top_badge']) ? 1 : 0;
 		$instance['desc'] = in_array($new_instance['desc'] ?? '', ['desc', 'user_registered', 'last_login', 'last_checkin'], true) ? $new_instance['desc'] : 'desc';
+		$instance['in_affix'] = !empty($new_instance['in_affix']) ? 1 : 0;
 		return $instance;
 	}
 }