fees.rb

[geekelo]

FILE

ActiveAdmin.register Fee do
  permit_params :name, :slug, :amount, :units, :currency, :status

  config.sort_order = 'name_asc'

  menu parent: 'Configuration', label: 'Fees'

  # See permitted parameters documentation:
  # https://github.com/activeadmin/activeadmin/blob/master/docs/2-resource-customization.md#setting-up-strong-parameters
  #
  # Uncomment all parameters which should be permitted for assignment
  #
  # permit_params :name, :slug, :amount, :units, :currency, :status
  #
  # or
  #
  # permit_params do
  #   permitted = [:name, :slug, :amount, :units, :currency, :status]
  #   permitted << :other if params[:action] == 'create' && current_user.admin?
  #   permitted
  # end
end

[geekelo]

This code sets up an admin interface for managing Fee records using ActiveAdmin. Here's an explanation of the key components:

1. Menu Configuration

• menu parent: 'Configuration', label: 'Fees':
  This places the Fee resource under the "Configuration" menu in the ActiveAdmin interface and labels it as "Fees." This helps in organizing the admin panel, making it easy for administrators to find and manage fee-related settings.

2. Permitted Parameters

• permit_params :name, :slug, :amount, :units, :currency, :status:
  This line specifies which parameters of the Fee model can be modified through the ActiveAdmin interface. This is crucial for security, as it prevents unauthorized mass assignment of parameters.

  The parameters include:

  • name: The name of the fee.
  • slug: A URL-friendly version of the name, typically used for easy reference.
  • amount: The numerical value of the fee.
  • units: The unit in which the fee is measured (e.g., percentage, flat rate).
  • currency: The currency in which the fee is denominated.
  • status: The status of the fee (e.g., active or inactive).

3. Sort Order Configuration

• config.sort_order = 'name_asc':
  This line configures the default sort order for the Fee records in the admin interface, sorting them by the name attribute in ascending order.

4. Commented Configuration

• # permit_params do ... end:
  This commented-out block shows an alternative way to define permitted parameters, allowing for conditional parameter permissions. It demonstrates how to add extra parameters if certain conditions are met, such as when the current user is an admin and is creating a new record.

  permit_params do
  permitted = [:name, :slug, :amount, :units, :currency, :status]
  permitted << :other if params[:action] == 'create' && current_user.admin?
  permitted
  end

  This is useful if you need to dynamically adjust the permitted parameters based on the context in which the action is being performed.

Summary

This configuration is focused on managing fee-related settings in your system through ActiveAdmin. It organizes the Fee resource under the "Configuration" menu, sets a default sort order, and securely defines which parameters can be modified by administrators. The commented-out sections provide examples of how to extend or customize this setup further if needed.