settings = $settings; $this->factory = $factory; } /** * Register shortcodes and shared styles. * * @return void */ public function register(): void { add_shortcode( 'verifycate_certificate', array( $this, 'certificateShortcode' ) ); add_shortcode( 'verifycate_verify', array( $this, 'verifyShortcode' ) ); } /** * Render one public certificate. * * @param array|string $atts Shortcode attributes. * @return string */ public function certificateShortcode( $atts ): string { $atts = shortcode_atts( array( 'public_id' => '', 'workspace' => '', ), is_array( $atts ) ? $atts : array(), 'verifycate_certificate' ); $public_id = sanitize_text_field( (string) $atts['public_id'] ); $workspace = sanitize_title( (string) $atts['workspace'] ); if ( '' === $public_id ) { return $this->adminNote( __( 'Add a public_id to the [verifycate_certificate] shortcode.', 'verifycate' ) ); } if ( ! $this->factory->isConfigured() ) { return $this->adminNote( __( 'Connect Verifycate before using this shortcode.', 'verifycate' ) ); } $certificate = $this->getCertificate( $public_id, $workspace ); if ( is_wp_error( $certificate ) ) { return '

' . esc_html( $certificate->get_error_message() ) . '

'; } return $this->renderCertificate( $certificate, $public_id ); } /** * Render a public verification form and its result. * * @param array|string $atts Shortcode attributes. * @return string */ public function verifyShortcode( $atts ): string { $atts = shortcode_atts( array( 'title' => __( 'Verify a certificate', 'verifycate' ), 'button' => __( 'Verify', 'verifycate' ), ), is_array( $atts ) ? $atts : array(), 'verifycate_verify' ); if ( ! $this->factory->isConfigured() ) { return $this->adminNote( __( 'Connect Verifycate before using this shortcode.', 'verifycate' ) ); } // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only public lookup. $public_id = isset( $_GET['verifycate_public_id'] ) ? sanitize_text_field( wp_unslash( (string) $_GET['verifycate_public_id'] ) ) : ''; $title = (string) $atts['title']; $button = (string) $atts['button']; $input_id = wp_unique_id( 'verifycate-public-id-' ); $html = '
'; if ( '' !== $title ) { $html .= '

' . esc_html( $title ) . '

'; } $html .= '
'; $html .= ''; $html .= ''; $html .= ''; $html .= '
'; if ( '' !== $public_id ) { $certificate = $this->getCertificate( $public_id, '' ); if ( is_wp_error( $certificate ) ) { $html .= '

' . esc_html( $certificate->get_error_message() ) . '

'; } else { $html .= $this->renderCertificate( $certificate, $public_id ); } } $html .= '
'; return $html; } /** * Fetch and normalize a public certificate. * * @param string $public_id Public certificate id. * @param string $workspace Optional workspace override. * @return array|\WP_Error */ private function getCertificate( string $public_id, string $workspace ) { $workspace_key = '' !== $workspace ? $workspace : $this->settings->getWorkspace(); $cache_key = 'verifycate_certificate_' . md5( $workspace_key . '|' . $public_id ); $cached = get_transient( $cache_key ); if ( is_array( $cached ) ) { /** * Cached public certificate data. * * @var array $cached */ return $cached; } try { $certificate = $this->factory->make()->verification()->get( $public_id, '' !== $workspace ? $workspace : null ); $data = $this->normalize( $certificate, $public_id ); set_transient( $cache_key, $data, self::TTL ); return $data; } catch ( ApiException $exception ) { if ( $exception->isNotFound() ) { return new \WP_Error( 'verifycate_certificate_not_found', __( 'No certificate was found with that public ID.', 'verifycate' ) ); } Logger::warning( 'Could not load a public certificate.', array( 'status' => $exception->getStatusCode(), 'error' => $exception->getMessage(), ) ); } catch ( TransportException $exception ) { Logger::warning( 'Could not reach the API for a public certificate.', array( 'error' => $exception->getMessage() ) ); } catch ( \Throwable $exception ) { Logger::warning( 'Unexpected error loading a public certificate.', array( 'error' => $exception->getMessage() ) ); } return new \WP_Error( 'verifycate_certificate', __( 'Certificate details are temporarily unavailable. Please try again later.', 'verifycate' ) ); } /** * Convert a public certificate DTO into cacheable data. * * @param PublicCertificate $certificate Certificate. * @param string $fallback_id Fallback public id. * @return array */ private function normalize( PublicCertificate $certificate, string $fallback_id ): array { $issued = $certificate->getIssuedAt(); $expires = $certificate->getExpiresAt(); return array( 'public_id' => '' !== $certificate->getPublicId() ? $certificate->getPublicId() : $fallback_id, 'status' => $certificate->getStatus(), 'recipient_name' => $certificate->getRecipientName(), 'certificate_name' => $certificate->getCertificateName(), 'issued_at' => null === $issued ? '' : $issued->format( DATE_ATOM ), 'expires_at' => null === $expires ? '' : $expires->format( DATE_ATOM ), 'png_url' => $certificate->getPngUrl(), 'pdf_url' => $certificate->getPdfUrl(), ); } /** * Render a certificate card. * * @param array $certificate Certificate data. * @param string $fallback_id Fallback public id. * @return string */ private function renderCertificate( array $certificate, string $fallback_id ): string { $public_id = isset( $certificate['public_id'] ) ? (string) $certificate['public_id'] : $fallback_id; $name = isset( $certificate['certificate_name'] ) ? (string) $certificate['certificate_name'] : ''; $recipient = isset( $certificate['recipient_name'] ) ? (string) $certificate['recipient_name'] : ''; $status = isset( $certificate['status'] ) ? (string) $certificate['status'] : ''; $pdf = isset( $certificate['pdf_url'] ) ? (string) $certificate['pdf_url'] : ''; $meta = array(); if ( ! empty( $certificate['issued_at'] ) ) { $timestamp = strtotime( (string) $certificate['issued_at'] ); if ( false !== $timestamp ) { /* translators: %s: issue date. */ $meta[] = sprintf( __( 'Issued %s', 'verifycate' ), wp_date( (string) get_option( 'date_format' ), $timestamp ) ); } } if ( ! empty( $certificate['expires_at'] ) ) { $timestamp = strtotime( (string) $certificate['expires_at'] ); if ( false !== $timestamp ) { /* translators: %s: expiry date. */ $meta[] = sprintf( __( 'Expires %s', 'verifycate' ), wp_date( (string) get_option( 'date_format' ), $timestamp ) ); } } $meta[] = 'active' === $status ? __( 'Active', 'verifycate' ) : __( 'Expired', 'verifycate' ); $view_url = rtrim( $this->settings->getPortalUrl(), '/' ) . '/c/' . rawurlencode( $public_id ); $class = 'active' === $status ? 'is-active' : 'is-expired'; $html = '
'; $html .= '
'; if ( '' !== $name ) { $html .= '

' . esc_html( $name ) . '

'; } if ( '' !== $recipient ) { $html .= '

' . esc_html( $recipient ) . '

'; } $html .= '

' . esc_html( implode( ' ยท ', $meta ) ) . '

'; $html .= '
'; $html .= '
'; $html .= '' . esc_html__( 'View certificate', 'verifycate' ) . ''; if ( '' !== $pdf ) { $html .= '' . esc_html__( 'Download PDF', 'verifycate' ) . ''; } $html .= '
'; $html .= '
'; return $html; } /** * Show a setup note only to administrators. * * @param string $message Message. * @return string */ private function adminNote( string $message ): string { if ( ! current_user_can( 'manage_options' ) ) { return ''; } return '

' . esc_html( $message ) . '

'; } }