Group class term dates, single-class embed mode, and offering editing

Group class offerings now carry real dates: the add/edit form takes a start date plus a sessions control (one-off, or weekly for N sessions; the end date is computed as start + (N-1) weeks via Offering::weeklyTermEnd). Dates are validated strictly (Y-m-d) and shown in the offerings list and on the student-facing class card, including the weekly session count. [us_group_classes offering="<id>"] (block attribute offeringId, chosen from a dropdown of active classes fetched from the public offerings endpoint) restricts the page to a single class so the enrolment flow can be embedded on a page dedicated to that class; a pinned class that is no longer offered reports itself closed instead of falling back to the catalog. Offerings are now editable from the admin screen: an Edit button prefills the shared add/edit form and saving posts usc_action=update. Updates always preserve the original owner and currency, and non-admin instructors can only load and update their own offerings. The form also gains the previously missing description field and an Active toggle (the admin-UI counterpart of the REST is_active flag) so an edit cannot wipe data the form never collected. Closes #59 Co-Authored-By: Claude Fable 5 <[email protected]>
2026-07-05 23:18:59 -03:00
parent 9d8924132c
commit cde8704267
15 changed files with 653 additions and 42 deletions
@@ -4,15 +4,21 @@ declare(strict_types=1);
 namespace Unsupervised\Schedular\GroupClass;

 use Unsupervised\Schedular\Auth\RoleManager;
+use Unsupervised\Schedular\Val;

 class GroupClassPage {

 	/**
 	 * Renders the group-class enrolment shortcode output.
 	 *
-	 * @param array<int|string, mixed> $atts Shortcode attributes (unused — reserved for future options).
+	 * Supported attributes: `offering` (shortcode) / `offeringId` (block) — an
+	 * offering id that restricts the page to a single class, so the shortcode
+	 * can be embedded on a page dedicated to that class. 0 or absent shows the
+	 * full browsable catalog.
+	 *
+	 * @param array<int|string, mixed> $atts Shortcode or block attributes.
 	 */
-	public function render( array $atts ): string { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
+	public function render( array $atts ): string {
 		if ( ! is_user_logged_in() ) {
 			$permalink = get_permalink();

@@ -31,6 +37,8 @@ class GroupClassPage {
 		wp_enqueue_style( 'us-scheduler' );
 		wp_enqueue_script( 'us-scheduler-group' );

+		$offeringId = absint( Val::int( $atts['offering'] ?? $atts['offeringId'] ?? 0 ) );
+
 		ob_start();
 		include USC_PLUGIN_DIR . 'templates/frontend/group-classes-page.php';
 		return (string) ob_get_clean();