2014-03-05 20:52:20 +08:00
|
|
|
<div class="badges">
|
2024-09-05 10:18:23 +08:00
|
|
|
<AdminPageHeader
|
|
|
|
|
@titleLabel="admin.badges.title"
|
2024-09-13 02:21:42 +08:00
|
|
|
@descriptionLabel="admin.badges.page_description"
|
2024-09-05 10:18:23 +08:00
|
|
|
@learnMoreUrl="https://meta.discourse.org/t/understanding-and-using-badges/32540"
|
|
|
|
|
>
|
|
|
|
|
<:breadcrumbs>
|
|
|
|
|
<DBreadcrumbsItem
|
|
|
|
|
@path="/admin/badges"
|
|
|
|
|
@label={{i18n "admin.badges.title"}}
|
|
|
|
|
/>
|
|
|
|
|
</:breadcrumbs>
|
|
|
|
|
<:actions as |actions|>
|
|
|
|
|
<actions.Primary
|
|
|
|
|
@route="adminBadges.show"
|
|
|
|
|
@routeModels="new"
|
|
|
|
|
@icon="plus"
|
|
|
|
|
@label="admin.badges.new"
|
2024-09-11 11:27:58 +08:00
|
|
|
class="new-badge"
|
2024-09-05 10:18:23 +08:00
|
|
|
/>
|
2020-01-14 01:44:22 +08:00
|
|
|
|
2024-09-05 10:18:23 +08:00
|
|
|
<actions.Default
|
|
|
|
|
@route="adminBadges.award"
|
|
|
|
|
@routeModels="new"
|
|
|
|
|
@icon="upload"
|
|
|
|
|
@label="admin.badges.mass_award.title"
|
2024-09-11 11:27:58 +08:00
|
|
|
class="award-badge"
|
2024-09-05 10:18:23 +08:00
|
|
|
/>
|
DEV: form-kit
This PR introduces FormKit, a component-based form library designed to simplify form creation and management. This library provides a single `Form` component, various field components, controls, validation mechanisms, and customization options. Additionally, it includes helpers to facilitate testing and writing specifications for forms.
1. **Form Component**:
- The main component that encapsulates form logic and structure.
- Yields various utilities like `Field`, `Submit`, `Alert`, etc.
**Example Usage**:
```gjs
import Form from "discourse/form";
<template>
<Form as |form|>
<form.Field
@name="username"
@title="Username"
@validation="required"
as |field|
>
<field.Input />
</form.Field>
<form.Field @name="age" @title="Age" as |field|>
<field.Input @type="number" />
</form.Field>
<form.Submit />
</Form>
</template>
```
2. **Validation**:
- Built-in validation rules such as `required`, `number`, `length`, and `url`.
- Custom validation callbacks for more complex validation logic.
**Example Usage**:
```javascript
validateUsername(name, value, data, { addError }) {
if (data.bar / 2 === value) {
addError(name, "That's not how maths work.");
}
}
```
```hbs
<form.Field @name="username" @validate={{this.validateUsername}} />
```
3. **Customization**:
- Plugin outlets for extending form functionality.
- Styling capabilities through propagated attributes.
- Custom controls with properties provided by `form` and `field`.
**Example Usage**:
```hbs
<Form class="my-form" as |form|>
<form.Field class="my-field" as |field|>
<MyCustomControl id={{field.id}} @onChange={{field.set}} />
</form.Field>
</Form>
```
4. **Helpers for Testing**:
- Test assertions for form and field validation.
**Example usage**:
```javascript
assert.form().hasErrors("the form shows errors");
assert.form().field("foo").hasValue("bar", "user has set the value");
```
- Helper for interacting with he form
**Example usage**:
```javascript
await formKit().field("foo").fillIn("bar");
```
5. **Page Object for System Specs**:
- Page objects for interacting with forms in system specs.
- Methods for submitting forms, checking alerts, and interacting with fields.
**Example Usage**:
```ruby
form = PageObjects::Components::FormKit.new(".my-form")
form.submit
expect(form).to have_an_alert("message")
```
**Field Interactions**:
```ruby
field = form.field("foo")
expect(field).to have_value("bar")
field.fill_in("bar")
```
6. **Collections handling**:
- A specific component to handle array of objects
**Example Usage**:
```gjs
<Form @data={{hash foo=(array (hash bar=1) (hash bar=2))}} as |form|>
<form.Collection @name="foo" as |collection|>
<collection.Field @name="bar" @title="Bar" as |field|>
<field.Input />
</collection.Field>
</form.Collection>
</Form>
```
2024-07-17 17:59:35 +08:00
|
|
|
|
2024-09-05 10:18:23 +08:00
|
|
|
<actions.Default
|
|
|
|
|
@action={{routeAction "editGroupings"}}
|
|
|
|
|
@title="admin.badges.group_settings"
|
|
|
|
|
@label="admin.badges.group_settings"
|
2024-09-13 23:50:52 +08:00
|
|
|
@icon="gear"
|
2024-09-05 10:18:23 +08:00
|
|
|
class="edit-groupings-btn"
|
DEV: form-kit
This PR introduces FormKit, a component-based form library designed to simplify form creation and management. This library provides a single `Form` component, various field components, controls, validation mechanisms, and customization options. Additionally, it includes helpers to facilitate testing and writing specifications for forms.
1. **Form Component**:
- The main component that encapsulates form logic and structure.
- Yields various utilities like `Field`, `Submit`, `Alert`, etc.
**Example Usage**:
```gjs
import Form from "discourse/form";
<template>
<Form as |form|>
<form.Field
@name="username"
@title="Username"
@validation="required"
as |field|
>
<field.Input />
</form.Field>
<form.Field @name="age" @title="Age" as |field|>
<field.Input @type="number" />
</form.Field>
<form.Submit />
</Form>
</template>
```
2. **Validation**:
- Built-in validation rules such as `required`, `number`, `length`, and `url`.
- Custom validation callbacks for more complex validation logic.
**Example Usage**:
```javascript
validateUsername(name, value, data, { addError }) {
if (data.bar / 2 === value) {
addError(name, "That's not how maths work.");
}
}
```
```hbs
<form.Field @name="username" @validate={{this.validateUsername}} />
```
3. **Customization**:
- Plugin outlets for extending form functionality.
- Styling capabilities through propagated attributes.
- Custom controls with properties provided by `form` and `field`.
**Example Usage**:
```hbs
<Form class="my-form" as |form|>
<form.Field class="my-field" as |field|>
<MyCustomControl id={{field.id}} @onChange={{field.set}} />
</form.Field>
</Form>
```
4. **Helpers for Testing**:
- Test assertions for form and field validation.
**Example usage**:
```javascript
assert.form().hasErrors("the form shows errors");
assert.form().field("foo").hasValue("bar", "user has set the value");
```
- Helper for interacting with he form
**Example usage**:
```javascript
await formKit().field("foo").fillIn("bar");
```
5. **Page Object for System Specs**:
- Page objects for interacting with forms in system specs.
- Methods for submitting forms, checking alerts, and interacting with fields.
**Example Usage**:
```ruby
form = PageObjects::Components::FormKit.new(".my-form")
form.submit
expect(form).to have_an_alert("message")
```
**Field Interactions**:
```ruby
field = form.field("foo")
expect(field).to have_value("bar")
field.fill_in("bar")
```
6. **Collections handling**:
- A specific component to handle array of objects
**Example Usage**:
```gjs
<Form @data={{hash foo=(array (hash bar=1) (hash bar=2))}} as |form|>
<form.Collection @name="foo" as |collection|>
<collection.Field @name="bar" @title="Bar" as |field|>
<field.Input />
</collection.Field>
</form.Collection>
</Form>
```
2024-07-17 17:59:35 +08:00
|
|
|
/>
|
2024-09-05 10:18:23 +08:00
|
|
|
</:actions>
|
|
|
|
|
</AdminPageHeader>
|
2024-09-10 05:33:43 +08:00
|
|
|
|
|
|
|
|
<div class="admin-container">
|
|
|
|
|
<div class="content-list">
|
|
|
|
|
<ul class="admin-badge-list">
|
|
|
|
|
{{#each this.model as |badge|}}
|
|
|
|
|
<li class="admin-badge-list-item">
|
|
|
|
|
<LinkTo @route={{this.selectedRoute}} @model={{badge.id}}>
|
|
|
|
|
<BadgeButton @badge={{badge}} />
|
|
|
|
|
{{#if badge.newBadge}}
|
|
|
|
|
<span class="list-badge">{{i18n
|
|
|
|
|
"filters.new.lower_title"
|
|
|
|
|
}}</span>
|
|
|
|
|
{{/if}}
|
|
|
|
|
</LinkTo>
|
|
|
|
|
</li>
|
|
|
|
|
{{/each}}
|
|
|
|
|
</ul>
|
|
|
|
|
</div>
|
|
|
|
|
{{outlet}}
|
2014-03-05 20:52:20 +08:00
|
|
|
</div>
|
2020-01-14 01:44:22 +08:00
|
|
|
</div>
|