Skip to content

SL-353/SL-354: fields settings block logic#316

Open
GytisZum wants to merge 2 commits intoSL-350/overall-design-changesfrom
SL-353/fields-settings-licence
Open

SL-353/SL-354: fields settings block logic#316
GytisZum wants to merge 2 commits intoSL-350/overall-design-changesfrom
SL-353/fields-settings-licence

Conversation

@GytisZum
Copy link
Copy Markdown
Collaborator

Self-Checks

  • I have performed a self-review of my code.
  • I have updated/added necessary technical documentation in the README file.

JIRA task link

Summary

QA Checklist Labels

  • Bug fix?
  • New feature?
  • Improvement?
  • Technical debt?
  • Reusable?
  • Covered by tests?

QA Checklist

Additional Context

Frontend Changes

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the Saferpay module's license management by implementing real-time license fetching and dynamically adjusting the user interface based on the retrieved license status. This ensures that the displayed features and configuration options accurately reflect the user's current Saferpay plan, improving user experience and reducing potential confusion regarding feature availability.

Highlights

  • Dynamic License Fetching: Implemented automatic re-fetching of Saferpay license information from the API on every settings page load to ensure the displayed license status is always up-to-date.
  • New License API Services: Introduced new PHP services and Data Transfer Objects (DTOs) specifically for handling Saferpay license API requests, including a fallback mechanism for different API endpoints.
  • Conditional UI Rendering: Modified the API credentials settings page to dynamically display the 'Saferpay Fields Configuration' section only when a business license is successfully detected, streamlining the user interface.
  • Simplified UI Interaction: Removed conditional disabling of input fields and buttons within the 'Saferpay Fields Configuration' section, making them always editable once the section is visible.
  • Translation Cleanup: Cleaned up unused translation strings related to messages indicating that Saferpay Fields are not available, aligning with the new conditional UI approach.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • controllers/admin/AdminSaferPayOfficialSettingsController.php
    • Updated the success message displayed after saving API credentials.
    • Added logic to re-fetch the Saferpay license from the API on page load using the currently configured credentials.
  • src/Api/Request/GetLicenseService.php
    • Added a new service responsible for making API requests to retrieve license information, including support for a fallback URL.
  • src/DTO/Request/GetLicense/GetLicenseRequest.php
    • Added a new Data Transfer Object (DTO) for constructing license request URLs, incorporating validation for the customer ID format.
  • src/Service/SaferPayGetLicense.php
    • Added a new service to orchestrate the fetching of Saferpay license details, process the API response, and determine the presence of a business license and associated features.
  • src/Service/SettingsTranslationService.php
    • Removed translation keys that were previously used for messages indicating the unavailability of Saferpay Fields, as this information is now handled by conditional UI rendering.
  • views/js/admin/settings-app/src/components/settings/api-credentials.tsx
    • Modified the rendering logic for the 'Saferpay Fields Configuration' card to only display if a business license is detected.
    • Removed the 'disabled' attribute from the 'Field Access Token' input, its associated 'Generate' button, and the 'JavaScript Library URL' input, making them always editable when the configuration section is visible.
Activity
  • No specific activity (comments, reviews, or progress updates) was provided in the context for this pull request.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces logic to fetch and handle Saferpay license information, which controls the visibility of "Saferpay Fields" settings. The frontend changes correctly hide this section if the user does not have the required business license, improving the UI. The backend adds new services and DTOs to communicate with the Saferpay API for license fetching, including a fallback mechanism which is a nice touch.

However, I have identified a couple of areas for improvement. Firstly, a new block of code in AdminSaferPayOfficialSettingsController fetches the license status on every page load. This is a performance concern and it fails silently, which can lead to a confusing user experience with stale data. I've recommended removing it or implementing caching and proper error handling. Secondly, the new service classes use mixed as a return type in PHPDocs, which weakens type safety. I've suggested using more specific types like object|null to improve code clarity and maintainability.

Comment on lines +455 to +472
if (!empty($activeUsername) && !empty($activePassword) && !empty($activeCustomerId)) {
try {
/** @var SaferPayGetLicense $getLicense */
$getLicense = $this->module->getService(SaferPayGetLicense::class);
$licenseInfo = $getLicense->fetchLicenseWithCredentials(
$activeUsername,
$activePassword,
$activeCustomerId,
$isTestMode
);
$configuration->set(
SaferPayConfig::BUSINESS_LICENSE . $suffix,
$licenseInfo['hasBusinessLicense'] ? 1 : 0
);
} catch (\Exception $e) {
// Silently fall back to stored value
}
}
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

Making an API call on every page load of the settings page can negatively impact performance and user experience, especially if the external API is slow to respond. Additionally, silently catching all exceptions (catch (\Exception $e)) hides potential issues from the user, such as invalid credentials or network problems. This can lead to confusion when the license status displayed is stale and doesn't reflect the actual state.

Consider removing this automatic refresh. The license status is already updated when credentials are saved, which provides better user feedback on failure. If a manual refresh is desired, a dedicated button would be more efficient.

If you must keep the automatic refresh, please consider these improvements:

  • Implement caching with a reasonable TTL (e.g., 1 hour) to avoid making an API call on every single page load.
  • Handle exceptions gracefully by logging the error and displaying a non-intrusive message to the user indicating that the license status could not be refreshed.

Comment thread src/Service/SaferPayGetLicense.php
@GytisZum GytisZum changed the title SL-353/ fields settings licence block logic and licence fetching SL-353: fields settings licence block logic and licence fetching Mar 16, 2026
@GytisZum GytisZum changed the title SL-353: fields settings licence block logic and licence fetching SL-353/SL-354: fields settings block logic Mar 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant