0, 'active' => false, ]; } $asked = '' !== get_user_meta( $user_id, self::ASKED, true ); /** * Whether step 3 may ask this user for a WordPress.org review after * their third finished export. Return false to never ask (an add-on, * or a site that doesn't want it). It is asked at most once either way. * * @param bool $show Default true. * @param int $user_id User. */ $enabled = (bool) apply_filters( 'modulary_export_review_prompt', true, $user_id ); return [ 'exports' => self::count_from( get_user_meta( $user_id, self::EXPORTS, true ) ), 'active' => $enabled && ! $asked, ]; } /** * One more finished export for a user. The answer that reaches AFTER * says `show: true` and marks the user as asked, so it is the only one * that ever does. Nothing is counted once the prompt is inactive. * * @param int $user_id User. * @return array{exports: int, active: bool, show: bool} The state after counting. */ public static function record_export( int $user_id ): array { $state = self::state( $user_id ); if ( ! $state['active'] ) { return $state + [ 'show' => false ]; } ++$state['exports']; update_user_meta( $user_id, self::EXPORTS, $state['exports'] ); if ( $state['exports'] < self::AFTER ) { return $state + [ 'show' => false ]; } update_user_meta( $user_id, self::ASKED, time() ); return [ 'exports' => $state['exports'], 'active' => false, 'show' => true, ]; } /** * Remove every user's count and "asked" mark (uninstall.php). */ public static function forget_all(): void { delete_metadata( 'user', 0, self::EXPORTS, '', true ); delete_metadata( 'user', 0, self::ASKED, '', true ); } /** * A stored count, read defensively: anything but a non-negative whole * number is 0. * * @param mixed $stored What get_user_meta() returned. */ public static function count_from( mixed $stored ): int { if ( is_int( $stored ) ) { return max( 0, $stored ); } if ( is_string( $stored ) && 1 === preg_match( '/^\d{1,18}$/D', $stored ) ) { return (int) $stored; } return 0; } }