✨ Student Review Component #2285

b-l-i-n-d · 2025-12-30T07:38:52Z

In this PR:

Make a dynamic review component with API integrations.
✨ New StarRatingInput, StartRating components
InputField component bugfix
Button component icon-only variant

…rmalinks, and refactor the given reviews template.

…dd review action transition, and remove debug output.

…/delete functionality, new API endpoints, and associated UI components.

…tandardize review form field names.

…omponent and update associated frontend logic

… successful review deletion.

sazedul-haque · 2026-01-05T04:40:14Z

assets/src/js/frontend/dashboard/pages/reviews.ts

+
+export const initializeReviews = () => {
+  window.TutorComponentRegistry.registerAll({
+    components: [reviewCardMeta, reviewServicesMeta],


Both will be initialized at the same time. I think it's best to keep everything inside one function. There are only 2 mutations.

Both will be initialized at the same time, but they are not used in the same level of DOM structure. reviewServicesMeta is used at an upper level to update deleteModal without creating a new one for each review-card.

sazedul-haque · 2026-01-05T04:40:45Z

assets/src/scss/frontend/dashboard/_reviews.scss

-    transition-property: background-color, border-color, opacity;
-    transition-duration: 0.2s;
-    transition-timing-function: ease-in-out;
+    @include tutor-transition((background-color, border-color, opacity));


Why double bracket?

This is the first parameter of the mixing, without brackets, it will be considered as three different parameters.

sazedul-haque · 2026-01-05T05:11:24Z

components/Button.php

 		return $this;
 	}

+	/**


We can determine if icon only or not programmatically. No need to add prop support.

Prop support is needed, as label will be used as aria-label for accessibility.

sazedul-haque · 2026-01-05T05:12:32Z

components/Button.php

-		$content = self::POSITION_RIGHT === ( $this->icon_position ? $this->icon_position : self::POSITION_LEFT )
-			? sprintf( '%1$s%2$s', esc_html( $this->label ), $icon_html )
-			: sprintf( '%1$s%2$s', $icon_html, esc_html( $this->label ) );
+		if ( $this->icon_only ) {


This is not necessary I guess.

When icon-only, we don't need to perform those checks; it's better to leave early when possible.

sazedul-haque · 2026-01-05T05:18:57Z

templates/demo-components/dashboard/components/star-rating.php

 if ( ! defined( 'ABSPATH' ) ) {
 	exit;
 }
+use TUTOR\Icon;


Why are we still working on demo components?

Removed demo component and created new StarRating component.

sazedul-haque · 2026-01-05T05:20:41Z

templates/dashboard/reviews/review-card.php

+			@submit.prevent="handleSubmit(
+				(data) => handleReviewSubmit(data),
+				(errors) => { 
+					console.log('Form errors:', errors); 


Display toast for errors.

This was not intentional. Removing this since we are handling errors inside query.

sazedul-haque · 2026-01-05T05:21:57Z

templates/dashboard/reviews/review-card.php

+				<div class="tutor-review-rating">
+					<?php
+					tutor_load_template(
+						'demo-components.dashboard.components.star-rating',


Why demo-components?

Used newly created component.

sazedul-haque · 2026-01-05T05:23:43Z

templates/dashboard/reviews/given-reviews.php

+				->message( __( 'Are you sure you want to delete this review? Please confirm your choice.', 'tutor' ) )
+				->confirm_handler( 'handleDeleteReview(payload?.id)' )
+				->mutation_state( 'deleteReviewMutation' )
+				->confirm_button(


No need to provide confirm_button and cancel_button. the default should work.

sazedul-haque · 2026-01-05T05:25:32Z

templates/dashboard/reviews/given-reviews.php

-			</ul>
-		</div>
-	<?php endif; ?>
+$converted_reviews = array_map(


Try to skip this. Update the review-card template accordingly.

sazedul-haque · 2026-01-05T05:26:44Z

assets/src/js/frontend/dashboard/pages/reviews.ts

+      return wpAjaxInstance.post(endpoints.PLACE_RATING, payload).then((res) => res.data);
+    },
+
+    convertFormDataToPayload(data: ReviewFormProps): ReviewPayload {


Try to skip this conversion.

This is needed as the payload does not match the input names.

…Modal

… card template.

…e` and `icon_size` for consistency.

…confirm_text` and `cancel_text` for modal actions.

…nd remove redundant data conversion.

…f `id` and `review_content`.

sazedul-haque · 2026-01-06T04:23:51Z

templates/dashboard/account/reviews.php

+			'paged'       => $current_page,
+		);
+
+		$pagination_template_frontend = tutor()->path . 'templates/dashboard/elements/pagination.php';


Please use pagination component.

This is part of the instructor design, which is not here yet. So, I kept the previous code as it was.

sazedul-haque · 2026-01-06T04:24:05Z

templates/dashboard/account/reviews.php

+			</table>
+		</div>
+	<?php else : ?>
+		<?php tutor_utils()->tutor_empty_state( tutor_utils()->not_found_text() ); ?>


Please use empty state component

This is part of the instructor design, which is not here yet. So, I kept the previous code as it was.

sazedul-haque · 2026-01-06T04:25:54Z

templates/dashboard/account/reviews.php

+	<?php endif; ?>
+
+	<?php if ( $reviews->count ) : ?>
+		<div class="tutor-table-responsive">


Where is this design?

harunollyo · 2026-01-07T05:32:52Z

components/InputField.php

-	 *
-	 * @return $this
-	 */
-	public function error( $error ) {


Why this method removed?

harunollyo · 2026-01-07T05:37:33Z

components/StarRating.php

+						</span>
+					<?php endif; ?>
+
+					<?php if ( null !== $this->count ) : ?>


We write simply
if ( $this->count )

harunollyo · 2026-01-07T05:38:26Z

components/StarRating.php

+				<?php endfor; ?>
+			</div>
+
+			<?php if ( $this->show_average || null !== $this->count ) : ?>


if ( $this->show_average || $this->count )

harunollyo · 2026-01-07T05:46:17Z

components/StarRatingInput.php

+	 *
+	 * @var string
+	 */
+	protected $field_name = '';


The default name should be rating

harunollyo · 2026-01-07T05:47:15Z

components/StarRatingInput.php

+	 *
+	 * @var int
+	 */
+	protected $icon_size = 20;


We can use Size::SIZE_20

harunollyo · 2026-01-07T06:11:27Z

templates/dashboard/reviews/review-card.php

+ * @link https://themeum.com
+ * @since 4.0.0
+ */
+


Prevent direct access

harunollyo · 2026-01-07T06:16:31Z

templates/demo-components/dashboard/components/profile-pages-header.php

 * @since 4.0.0
 */

 use TUTOR\Icon;


Revert this file changes. This is not part of this PR

harunollyo · 2026-01-07T06:17:07Z

templates/demo-components/dashboard/components/review-card.php

@@ -1,87 +0,0 @@
-<?php


Why this file has been removed?

harunollyo · 2026-01-07T06:18:37Z

templates/demo-components/playground.php

 		'learning-area'      => 'Learning Area',
 		'user-profile'       => 'User Profile',
 		'certificates'       => 'Certificates',
-		'reviews'            => 'Reviews',


Do not remove

harunollyo · 2026-01-07T06:18:54Z

templates/demo-components/reviews.php

@@ -1,27 +0,0 @@
-<?php
-/**


Do not remove demo component now

b-l-i-n-d added 12 commits December 24, 2025 12:17

feat: Make profile header sticky, standardize dashboard navigation pe…

8851da4

…rmalinks, and refactor the given reviews template.

feat: Enhance the Button component with an icon-only option.

b758b4a

feat: Implement dynamic review card rendering with structured data, a…

671ea8b

…dd review action transition, and remove debug output.

Merge branch '4.0.0-dev' into v4-reviews

d69b3fd

fix: Error and clear button not rendering properly

22d42b6

feat: new Icons added

2d9e39e

feat: Interactive star rating component

459ec91

feat: allow users to manage their given reviews in the dashboard

75734cf

feat: Add frontend dashboard page for managing user reviews with edit…

25c62fa

…/delete functionality, new API endpoints, and associated UI components.

Merge branch '4.0.0-dev' into v4-reviews

9be916f

feat: Add pagination and empty state to given reviews dashboard and s…

16e5668

…tandardize review form field names.

chore: Update imports

baa61e4

b-l-i-n-d added the 4.0.0 Tutor v4.w0w label Dec 30, 2025

b-l-i-n-d requested review from harunollyo, sazedul-haque and shewa12 December 30, 2025 07:38

b-l-i-n-d marked this pull request as draft December 30, 2025 07:39

b-l-i-n-d added 8 commits December 30, 2025 15:18

chore: Remove unused codes

04f2485

refactor: Remove unused codes

77de185

refactor: Remove unnecessary exports

d44db6a

Merge branch '4.0.0-dev' into v4-reviews

945c6c4

refactor: Use tutor-transition mixing

4be26a7

Merge branch '4.0.0-dev' into v4-reviews

542256d

refactor: reimplement review deletion modal using ConfirmationModal c…

7857a3d

…omponent and update associated frontend logic

feat: Add loading state to delete review button and reload page after…

6876633

… successful review deletion.

b-l-i-n-d marked this pull request as ready for review January 1, 2026 10:50

sazedul-haque requested changes Jan 5, 2026

View reviewed changes

b-l-i-n-d added 3 commits January 5, 2026 15:26

feat: swap confirm and cancel button styles and order in Confirmation…

c0d18be

…Modal

feat: introduce StarRating component and integrate it into the review…

3aec007

… card template.

refactor: rename showAverage and iconSize methods to `show_averag…

64aaddc

…e` and `icon_size` for consistency.

b-l-i-n-d added 6 commits January 5, 2026 15:32

chore: remove reviews demo component and its associated template file.

872369c

style: update star rating average and count text styling classes

aac71d7

refactor: replace confirm_button and cancel_button methods with `…

78cc51f

…confirm_text` and `cancel_text` for modal actions.

style: Update confirmation button class from primary to destructive.

e1a6c44

refactor: Align review data structure with WordPress comment fields a…

82d07e3

…nd remove redundant data conversion.

fix: Use comment_ID and comment_content for review data instead o…

095ae21

…f `id` and `review_content`.

b-l-i-n-d requested a review from sazedul-haque January 5, 2026 09:59

Merge branch '4.0.0-dev' into v4-reviews

5833abf

sazedul-haque requested changes Jan 6, 2026

View reviewed changes

b-l-i-n-d requested a review from sazedul-haque January 6, 2026 05:31

harunollyo requested changes Jan 7, 2026

View reviewed changes

✨ Student Review Component #2285

Are you sure you want to change the base?

✨ Student Review Component #2285

Conversation

b-l-i-n-d commented Dec 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

b-l-i-n-d Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

b-l-i-n-d Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

b-l-i-n-d Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

b-l-i-n-d Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

b-l-i-n-d Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

b-l-i-n-d Jan 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

b-l-i-n-d commented Dec 30, 2025 •

edited

Loading

b-l-i-n-d Jan 5, 2026 •

edited

Loading

b-l-i-n-d Jan 5, 2026 •

edited

Loading

b-l-i-n-d Jan 5, 2026 •

edited

Loading

b-l-i-n-d Jan 5, 2026 •

edited

Loading

b-l-i-n-d Jan 5, 2026 •

edited

Loading

b-l-i-n-d Jan 6, 2026 •

edited

Loading