A MyBB-style user reputation system for Discourse. Allows community members to rate each other with positive, neutral, or negative ratings accompanied by comments.

• Features
• Quick Start
• Screenshots
• Installation
• Configuration
• Usage
• API Endpoints
• Database Schema
• Frontend Components
• Architecture
• Development
• Localization
• Troubleshooting
• Contributing
• License

• Three Rating Types: Positive (+1), Neutral (0), Negative (-1)
• One Rating Per Pair: Each user can only have one active rating per target user (can update/delete)
• Required Comments: Configurable minimum character requirement for rating comments
• Configurable Points: Admin-defined point values per rating type
• Moderation Tools: Staff can hide/unhide ratings with reason tracking
• Multiple Display Locations: Show reputation in user cards, posts, and profiles
• Interaction Requirement: Optional toggle to require topic interaction before rating
• Category Filtering: Limit interaction checks to specific categories
• Cooldown Period: Configurable days before a rating can be modified
• Soft Delete: Ratings are soft-deleted with full audit trail
• Localization: Supports multiple languages (English, Spanish included)

# 1. Clone into your Discourse plugins directory cd /var/discourse/plugins git clone https://github.com/JoaquinSantarcangelo/discourse-user-reputation.git # 2. Rebuild the container cd /var/discourse && ./launcher rebuild app # 3. Configure in Admin > Settings > search "user_reputation"

For detailed installation options, see Installation.

Reputation score displayed on user profiles with "Rate this user" button.

Reputation breakdown shown in user hover cards.

Modal dialog for creating ratings with positive/neutral/negative options.

User activity page showing all ratings received with full details.

Plugin configuration in the admin panel.

1. Add the plugin to your container configuration

   Edit your app.yml file (usually at /var/discourse/containers/app.yml):

   hooks: after_code: - exec: cd: $home/plugins cmd: - git clone https://github.com/JoaquinSantarcangelo/discourse-user-reputation.git

2. Rebuild the container

   cd /var/discourse ./launcher rebuild app

3. Configure the plugin

   Go to Admin > Settings and search for user_reputation to configure.

1. Clone the plugin into your plugins directory

   cd /path/to/discourse/plugins git clone https://github.com/JoaquinSantarcangelo/discourse-user-reputation.git

2. Run database migrations

   Important: Plugin migrations require the LOAD_PLUGINS=1 flag to be detected.

   LOAD_PLUGINS=1 bin/rails db:migrate

3. Restart your Discourse server

   bin/rails server

4. Optional: Seed test data

   # Create test users bundle exec rake reputation:seed # Create sample ratings bundle exec rake reputation:seed_ratings

Navigate to Admin > Settings and search for user_reputation:

1. Rate from Posts: Click the star icon in the post menu to rate the post author
2. Rate from Profile: Visit a user's profile and click the rate button (if enabled)
3. View Reputation: See a user's full reputation history at /u/{username}/activity/reputation
4. Edit/Delete: Modify your own ratings within the cooldown period

1. Hide Ratings: Hide inappropriate ratings with optional reason
2. Unhide Ratings: Restore hidden ratings
3. View All: See hidden ratings and moderation history

Base path: /reputation

Create Rating:

POST /reputation { "target_user_id": 123, "rating_type": "positive", "comment": "Excellent seller, fast and reliable!", "topic_id": 456 }

Response:

{ "id": 789, "author_id": 1, "target_user_id": 123, "rating_type": "positive", "points": 1, "comment": "Excellent seller, fast and reliable!", "created_at": "2024-01-15T10:00:00Z" }

Get User Reputation:

GET /reputation/users/username { "score": 15, "breakdown": { "positive": 18, "neutral": 2, "negative": 3 }, "ratings": [...] }

Table: user_reputations

Indexes:

• author_id - Lookup by rating author
• target_user_id - Lookup by rated user
• (author_id, target_user_id) UNIQUE WHERE deleted_at IS NULL
• topic_id, rating_type, created_at, deleted_at

Route: /u/:username/activity/reputation

Displays:

• Total score with color coding
• Breakdown by rating type
• Paginated list of all ratings received
• Edit/delete controls for own ratings
• Hide/unhide controls for staff

flowchart TB subgraph Frontend["Frontend (Ember.js)"] UI[UI Components] API[reputation-api.js] Routes[Routes & Templates] end subgraph Backend["Backend (Rails)"] Controller[ReputationController] Engine[ReputationEngine] Model[UserReputation Model] Serializer[UserReputationSerializer] end subgraph Database DB[(user_reputations)] end UI --> API API -->|AJAX| Controller Controller --> Engine Controller --> Model Controller --> Serializer Engine --> Model Model --> DB Serializer -->|JSON| API 

sequenceDiagram actor User participant Modal as Rating Modal participant API as reputation-api.js participant Controller as ReputationController participant Engine as ReputationEngine participant Model as UserReputation participant DB as Database User->>Modal: Click "Rate User" Modal->>Modal: Select rating type + comment User->>Modal: Submit Modal->>API: createRating(data) API->>Controller: POST /reputation Controller->>Engine: can_rate?(author, target) Engine-->>Controller: true/false alt Can Rate Controller->>Model: create(params) Model->>DB: INSERT DB-->>Model: record Model-->>Controller: reputation Controller-->>API: JSON response API-->>Modal: Success Modal-->>User: Rating created else Cannot Rate Controller-->>API: Error + reason API-->>Modal: Error Modal-->>User: Show error message end 

erDiagram users ||--o{ user_reputations : "gives ratings" users ||--o{ user_reputations : "receives ratings" topics ||--o{ user_reputations : "optional link" posts ||--o{ user_reputations : "optional link" user_reputations { int id PK int author_id FK int target_user_id FK int rating_type "1/0/-1" int points text comment int topic_id FK int post_id FK boolean hidden int hidden_by_id FK datetime hidden_at text hidden_reason datetime deleted_at int deleted_by_id FK datetime created_at datetime updated_at } 

graph TD subgraph Profile["User Profile"] RUB[rate-user-button] RS[reputation-stat] end subgraph Card["User Card"] RB[reputation-badge] end subgraph Posts["Post Stream"] RAB[rate-author-button] PR[post-reputation] end subgraph Activity["Activity Page"] RLI[reputation-list-item] RSC[reputation-score] end subgraph Modal["Rating Modal"] RRM[reputation-rating-modal] end RUB -->|opens| RRM RAB -->|opens| RRM RRM -->|creates/updates| RLI 

discourse-user-reputation/ ├── plugin.rb # Main plugin file ├── README.md # Documentation ├── app/ │ ├── controllers/ │ │ └── reputation_controller.rb │ ├── models/ │ │ └── user_reputation.rb │ └── serializers/ │ └── user_reputation_serializer.rb ├── assets/ │ ├── javascripts/discourse/ │ │ ├── components/ # UI components │ │ ├── connectors/ # Plugin outlets │ │ ├── services/ │ │ │ └── reputation-api.js │ │ ├── routes/ │ │ └── templates/ │ └── stylesheets/ │ └── reputation.scss ├── config/ │ ├── settings.yml # Plugin settings │ └── locales/ # Translations (en, es) ├── db/migrate/ │ └── 20241220000001_create_user_reputations.rb └── lib/ ├── reputation_engine.rb # Business logic └── tasks/ └── seed.rake # Development seed data 

UserReputation Model:

• Scopes: active, visible, for_user, by_user, positive_ratings, negative_ratings
• Methods: soft_delete!, hide!, unhide!, can_be_modified_by?
• Class methods: calculate_total_score, breakdown_for, existing_rating

ReputationEngine:

• can_rate?(author, target) - Check if rating is allowed
• cannot_rate_reason(author, target) - Get denial reason
• has_interaction?(user1, user2) - Verify topic interaction
• color_class_for_score(score) - CSS class for styling

User Model Extensions:

• reputation_score - Get user's total score
• reputation_breakdown - Get count by type
• can_rate_user?(target) - Permission check

# Create test users (6 users with different trust levels) bundle exec rake reputation:seed # Create sample reputation ratings between test users bundle exec rake reputation:seed_ratings

Test Users Created:

# Ruby specs LOAD_PLUGINS=1 bin/rspec plugins/discourse-user-reputation/spec # JavaScript tests bin/qunit plugins/discourse-user-reputation/test

bin/lint plugins/discourse-user-reputation

Translation files in config/locales/:

• client.{locale}.yml - Frontend strings
• server.{locale}.yml - Backend strings

Included languages: English (en), Spanish (es)

To add a new language, create the corresponding locale files following the existing structure.

The plugin migrations haven't run. Run migrations with the plugin flag:

LOAD_PLUGINS=1 bin/rails db:migrate

Then restart your Rails server.

1. Check that the plugin is in the correct directory: plugins/discourse-user-reputation/
2. Ensure plugin.rb exists in the plugin root
3. Check Discourse logs for errors: ./launcher logs app

1. Verify the plugin is enabled: Admin > Settings > search user_reputation_enabled
2. Check display settings: user_reputation_show_in_posts, user_reputation_show_in_user_card

1. Check your trust level meets the minimum requirement
2. If interaction is required, ensure you've participated in topics with the user
3. Verify you haven't already rated the user

Contributions are welcome! Here's how you can help:

• Search existing issues before creating a new one
• Include Discourse version, plugin version, and steps to reproduce

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-feature)
3. Follow existing code style and conventions
4. Test your changes locally (see Development)
5. Submit a pull request with a clear description

1. Copy config/locales/client.en.yml to client.{locale}.yml
2. Copy config/locales/server.en.yml to server.{locale}.yml
3. Translate all strings
4. Submit a pull request

This project is licensed under the MIT License - see the LICENSE file for details.