Skip to content

Conversation

kidinov
Copy link
Contributor

@kidinov kidinov commented Aug 13, 2025

WOOMOB-1028

Description

Add Help section to WooPos settings screen with three menu items: "Where are my products", "Documentation", and "Get support". The Help category is positioned at the bottom of the settings categories and is not part of the scrollable content. The product info dialog now displays as a full-screen overlay instead of being confined to the details pane.

Steps to reproduce

  1. Navigate to WooPos settings screen
  2. Observe the Help section at the bottom of the categories pane
  3. Select the Help category to view the help options
  4. Click "Where are my products" to see the product info dialog displayed full screen
  5. Click "Documentation" to open the documentation URL
  6. Click "Get support" to open the support form

Testing information

  • Test on tablet devices to verify proper 2-pane layout behavior
  • Verify Help category remains fixed at bottom and doesn't scroll
  • Confirm dialog displays over entire settings interface, not just details pane
  • Test all three help menu items function correctly

The tests that have been performed

  • Verified Help category displays at bottom of categories list
  • Tested product info dialog shows as full-screen overlay
  • Confirmed documentation and support links work properly
  • Tested settings navigation and back button functionality

Images/gif

08-13--16-13.mp4
  • I have considered if this change warrants release notes and have added them to RELEASE-NOTES.txt if necessary. Use the "[Internal]" label for non-user-facing changes.

@dangermattic
Copy link
Collaborator

dangermattic commented Aug 13, 2025

3 Warnings
⚠️ This PR is larger than 300 lines of changes. Please consider splitting it into smaller PRs for easier and faster reviews.
⚠️ Class WooPosSettingsHardwareViewModel is missing tests, but unit-tests-exemption label was set to ignore this.
⚠️ Class WooPosSettingsHelpDetailViewModel is missing tests, but unit-tests-exemption label was set to ignore this.

Generated by 🚫 Danger

@wpmobilebot
Copy link
Collaborator

wpmobilebot commented Aug 13, 2025

📲 You can test the changes from this Pull Request in WooCommerce-Wear Android by scanning the QR code below to install the corresponding build.
App Name WooCommerce-Wear Android
Platform⌚️ Wear OS
FlavorJalapeno
Build TypeDebug
Commitf9da1cb
Direct Downloadwoocommerce-wear-prototype-build-pr14466-f9da1cb.apk

Base automatically changed from woomob-1023-woo-possettings-2-pane-layout-based-on-the-wireframes to trunk August 14, 2025 07:54
@kidinov kidinov requested a review from samiuelson August 14, 2025 08:02
@kidinov kidinov added this to the 23.1 milestone Aug 14, 2025
@kidinov kidinov marked this pull request as ready for review August 14, 2025 08:03
@wpmobilebot
Copy link
Collaborator

wpmobilebot commented Aug 14, 2025

📲 You can test the changes from this Pull Request in WooCommerce Android by scanning the QR code below to install the corresponding build.

App Name WooCommerce Android
Platform📱 Mobile
FlavorJalapeno
Build TypeDebug
Commitf9da1cb
Direct Downloadwoocommerce-prototype-build-pr14466-f9da1cb.apk

@samiuelson samiuelson self-assigned this Aug 14, 2025
@samiuelson samiuelson requested a review from Copilot August 14, 2025 11:04
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR adds a Help section to the WooPos settings screen with three menu items: "Where are my products", "Documentation", and "Get support". The Help category is positioned at the bottom of the settings categories and is not part of the scrollable content, while the product info dialog now displays as a full-screen overlay instead of being confined to the details pane.

  • Added Help category to settings with three options: product info, documentation, and support
  • Refactored hardware settings screen to use shared component pattern
  • Modified product info dialog to display full-screen instead of within the details pane

Reviewed Changes

Copilot reviewed 16 out of 17 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
strings.xml Added subtitle strings for help section menu items
WooPosSettingsHelpDetailViewModel.kt New view model handling help section navigation and URL opening
WooPosSettingsHelpDetailScreen.kt New composable screen displaying help menu items
WooPosSettingsHardwareViewModel.kt Renamed class for consistency
WooPosSettingsHardwareScreen.kt New implementation using shared menu item component
WooPosHardwareSettingsScreen.kt Removed old hardware screen implementation
WooPosSettingsDetailsMenuItem.kt New shared component for settings menu items
WooPosSettingsDetailPaneScreen.kt Added help screen case and product dialog callback
WooPosSettingsCategoriesState.kt Added HELP category enum value
WooPosSettingsCategoriesPaneScreen.kt Modified layout to position Help category at bottom
WooPosSettingsViewModel.kt Added dialog state management for product info dialog
WooPosSettingsState.kt Added dialog state property and Help destination
WooPosSettingsScreen.kt Added product info dialog overlay rendering
WooPosToolbarViewModel.kt Updated import for moved documentation URL constant
WooPosAppUrls.kt Added documentation URL constant
AppUrls.kt Removed POS documentation URL (moved to WooPosAppUrls)

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

Copy link
Contributor

@samiuelson samiuelson left a comment

Choose a reason for hiding this comment

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

LGTM!

@kidinov kidinov enabled auto-merge August 14, 2025 12:53
@kidinov kidinov merged commit 5efc125 into trunk Aug 14, 2025
17 checks passed
@kidinov kidinov deleted the woomob-1028-woo-possettings-add-help-section branch August 14, 2025 13:10
@codecov-commenter
Copy link

Codecov Report

❌ Patch coverage is 0% with 68 lines in your changes missing coverage. Please review.
✅ Project coverage is 37.95%. Comparing base (261ca27) to head (f9da1cb).
⚠️ Report is 11 commits behind head on trunk.

Files with missing lines Patch % Lines
.../settings/details/WooPosSettingsDetailsMenuItem.kt 0.00% 33 Missing ⚠️
...roid/ui/woopos/settings/WooPosSettingsViewModel.kt 0.00% 11 Missing ⚠️
.../details/help/WooPosSettingsHelpDetailViewModel.kt 0.00% 11 Missing ⚠️
.../android/ui/woopos/settings/WooPosSettingsState.kt 0.00% 7 Missing ⚠️
...ttings/categories/WooPosSettingsCategoriesState.kt 0.00% 5 Missing ⚠️
...etails/hardware/WooPosSettingsHardwareViewModel.kt 0.00% 1 Missing ⚠️
Additional details and impacted files
@@             Coverage Diff              @@
##              trunk   #14466      +/-   ##
============================================
- Coverage     37.98%   37.95%   -0.03%     
  Complexity     9229     9229              
============================================
  Files          2000     2002       +2     
  Lines        112622   112683      +61     
  Branches      14855    14859       +4     
============================================
- Hits          42775    42774       -1     
- Misses        65951    66013      +62     
  Partials       3896     3896              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants