Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/blazingapple/survey

Survey Components and Service for Blazor WASM Application Consumption
https://github.com/blazingapple/survey

blazor surveys webassembly

Last synced: 7 days ago
JSON representation

Survey Components and Service for Blazor WASM Application Consumption

Awesome Lists containing this project

README

        

# BlazingApple.Survey :apple:

:fire: A totally copacetic, easy-to-use front-end Blazor Survey package.
This front-end Razor Class Library is intended to be used by Blazor WASM projects, and targets .NET 5.

## About BlazingApples
BlazingApples is an open-source set of packages that aims to speed application development for Blazor WebAssembly organizations.

:zap: Check out the [demo site here](https://blazorsimplesurvey.azurewebsites.net/displaysurvey), [or this blog post on how the components work](https://blazorhelpwebsite.com/ViewBlogPost/44)!

:clap: Special thanks to [ADefWebServer](https://github.com/ADefWebserver/BlazorSimpleSurvey/commits?author=ADefWebserver) for creating the [BlazorSimpleSurvey](https://github.com/ADefWebserver/BlazorSimpleSurvey) demo application which this is based off of.

# Demo :video_camera:
Demo of BlazingApple.Survey

# Installation :wrench:

## 1. Get the required dependencies.

1. On Client Project, right click and get to the NuGet Package Manager ("Manage NuGetPackages").
2. Install `BlazingApple.Survey`
Survey Administration

3. Add the following to `Program.cs's Main`:
```
builder.Services.AddScoped();
builder.Services.AddScoped();
builder.Services.AddScoped();
builder.Services.AddScoped();
```

4. In your `index.html` file, add the required Radzen style and script:
```


```

## 2. Set up your server's API controller to receive the requests.
It is recommended to do this with EntityFrameworkCore to create the tables in my database and receive and process the request. This portion of the setup shows how to do this.

1. In your `Server` project, open `ApplicationDbContext`, add the following tables:
```
using BlazingApples.Shared;
...
public DbSet Surveys { get; set; }
public DbSet SurveyAnswers { get; set; }
public DbSet SurveyItems { get; set; }
public DbSet SurveyItemOptions { get; set; }
```
2. Create a `SurveysController.cs` in the `Controllers` directory, use [this controller](https://github.com/BlazingApple/Survey/blob/main/examples/BlazingAppleConsumer.Survey/Server/Controllers/SurveysController.cs) as the controller.

3. In the `Package Manager Console`, enter the following commands:
Survey Administration
```
Add-Migration AddSurveyData
Update-Database
```
Now you should be all set to use the components.

# Usage :muscle:

Once the (admittedly rather involved) setup is complete, using the components is straightforward:

1. In a component, add the `` component to show surveys to a user. If no survey is provided, this component will download all the active surveys from the server and give the user options to take them.
2. Use the `` component in a page in which you'd like to enable users to create or modify surveys.
3. Step 3

## Credits :white_flower:

- Build with love :blue_heart:, using [Radzen's Component Library](https://razor.radzen.com/) and [ADefWebServer](https://github.com/ADefWebserver/BlazorSimpleSurvey/commits?author=ADefWebserver)'s [BlazorSimpleSurvey](https://github.com/ADefWebserver/BlazorSimpleSurvey) as a starting point.

## Authors :pencil:

1. [Taylor White](https://twitter.com/taychasewhite)

## License :scroll:

![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)

- **[GPLv2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)**

## Home Page :camera:
Survey Administration

## Taking Surveys :camera:
Taking a Survey

## Monitoring Responses :camera:
Survey Responses