arrebagrove / uwp-ratemyapp

https://github.com/Microsoft/rate-my-app UWP version

UWP-RateMyApp

Version: 2.0.1.0

The UWP version of Microsoft's https://github.com/Microsoft/rate-my-app

NuGet: https://www.nuget.org/packages/RateMyApp.UWP/

Targeting Platform

• Windows 10 Build 10586+
• Windows 10 Mobile Build 10586+

Changes to Original RateMyApp Control

• Replace Border control with ContentDialog
• Remove Visiblity Property (Because by using ContentDialog, we no longer need to set the Visibilty of the Feedback Overlay)
• Improve code readability
• Migrate to C#6
• More Chinese like zh-CN lanugage
• Remove Windows 8.1 and Windows Phone 8.x projects

Usage

To install RateMyApp.UWP, run the following command in the Package Manager Console

PM > Install-Package RateMyApp.UWP

Add a FeedbackOverlay control to your layout page. (e.g. MainPage.xaml)

Required properties:

• FeedbackTo
• ApplicationName
• CompanyName

<Grid x:Name="LayoutRoot" Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <!-- Feedback overlay -->
    <controls:FeedbackOverlay x:Uid="RMA" 
                x:Name="FeedbackOverlay"
                FeedbackTo="[email protected]"
                ApplicationName="Another Funcking App"
                CompanyName="Superhard"
                FirstCount="2"
                SecondCount="4" />
</Grid>

Build and Run the app.

Senarios

• Given the app developer set the FirstCount and SecondCount value.
• When user launch the app for the FirstCount time.
• Then a content dialog is shown with two buttons.
• When user click "rate 5 starts" button.
• Then the user is taken to the Windows Store review page of the current app.
• Then the content dialog will never show again.

• Given the app developer set the FirstCount and SecondCount and FeedbackTo value.
• When user launch the app for the FirstCount time.
• Then a content dialog is shown with two buttons.
• When user click "no thanks" button.
• Then the content dialog will show with title "Can we make it better" and two buttons.
• When the user click "give feedback" button
• Then the default email program will be opened on the device with to address set to FeedbackTo.

• Given the user has clicked the "no thanks" button for the first two times.
• When user launch the app for the SecondCount time.
• Then a content dialog is shown with two buttons.
• When user click "no thanks" button.
• Then the content dialog will never show again.

Original Rate My App Readme

The Rate My App component is used to create prompts that appear at set intervals and allow the user to provide feedback and rate the application in the Windows Phone Store.

By default, when the application with Rate My App component is started for the 5th time, a dialog for reviewing the app is shown to the user. If the user declines to review the app, she will be given the option to provide direct feedback to the developer. On the 10th run of the app, if a review was not already collected, the user will be prompted one more time to rate the app. The interval of showing the dialogs, as well as the precise textual content of the dialogs can be configured to better suit your needs.

This solution consists of Rate My App component and several demo applications demonstrating how Rate My App component can be integrated to various kinds of Windows Phone applications like XAML, Panorama, XAML/XNA, XAML/Direct3D apps.

This solution is hosted in GitHub: https://github.com/Microsoft/rate-my-app

Rate My App component is also available through NuGet Package Manager. Search NuGet repositories for "RateMyApp", install it on your application, and follow the instructions in Rate My App Guide to easily integrate review and feedback functionality to your app.

Tested Device

• Microsoft Surface Pro 3 (Windows 10 Pro v1607)
• Microsoft Lumia 950 XL (Windows 10 Mobile Build 14393)
• Microsoft Lumia 640 (Windows 10 Mobile Build 14393)

Known Issues

No