airdrops.rb

[geekelo]

FILE

ActiveAdmin.register Airdrop do
  actions :all, except: :destroy

  includes :store

  menu parent: 'Stores', label: 'Airdrops'

  permit_params :store_id, :airdrop_type, :name, :description, :blockchain, :token_symbol, :currency, :exchange_rate, 
                :status, :active, :completed_at,
                :recipients_csv

  action_item :admin_send_airdrop_tokens, only: :show do
    if resource.pending? && resource.active
      a 'Send Tokens to Airdrop Recipients', href: admin_send_airdrop_tokens_admin_airdrop_path(resource) 
    end
  end

  member_action :admin_send_airdrop_tokens do
    resource.send_airdrop_tokens
    flash[:notice] = "Sending airdrop tokens to recipients has been scheduled"
    redirect_to [:admin, resource]
  end

  form  html: { multipart: true } do |f|
    f.semantic_errors *f.object.errors.attribute_names
    f.inputs do
      panel 'Airdrop Status' do
        f.input :status, as: :select, collection: Airdrop::AIRDROP_STATUS
        f.input :completed_at, as: :datepicker, datepicker_options: { min_date: 1.day.ago.to_date, max_date: "+0" }
      end
      panel 'Airdrop Info' do
        para ''
        f.input :airdrop_type, as: :select, collection: Airdrop::AIRDROP_TYPES
        f.input :name
        f.input :store, as: :select, collection: Store.active
        f.input :description
        para ''
        f.input :blockchain, as: :select, collection: WalletAddress::BLOCKCHAINS
        para ''
        f.input :token_symbol, as: :select, collection: WalletAddress::CRYPTOCURRENCIES.keys
        para 'cryptocurrency symbol'
        f.input :currency, as: :select, collection: ['USD']
        para ''
        f.input :exchange_rate
        para '1 <token_symbol> = exchange_rate X <Currency> (1 OPAIG = 0.01 USD)'
        para "<br>".html_safe
        f.input :active
      end

      panel 'Airdrop Recipients', 'data-panel': :collapsed do
        para 'Upload csv file and save to import airdrop recipients. To import more recipients, simply replace the file'
        para ''
        f.input :recipients_csv, as: :file
        para ''
        para 'CSV Format must include these headers with data:'
        para "<code>participation, ref1, balance, wallet_address, token_balance</code>".html_safe
        para "<code>5,0,5,wallet_address, 500</code>".html_safe
      end
    end
    f.actions
  end
end

[geekelo]

This code configures the admin interface for managing Airdrop records in an ActiveAdmin panel within a Ruby on Rails application. Here's a detailed explanation of what's happening:

File: airdrop.rb

1. ActiveAdmin.register Airdrop do

• Registers the Airdrop model with ActiveAdmin, creating an admin interface for managing Airdrop records.

2. actions :all, except: :destroy

• Enables all default CRUD actions except for the destroy action, preventing users from deleting Airdrop records via the admin interface.

3. includes :store

• Eager loads the associated store when querying Airdrop records, improving performance by reducing the number of database queries.

4. menu parent: 'Stores', label: 'Airdrops'

• Places the Airdrop resource under the Stores menu with the label Airdrops in the ActiveAdmin interface, helping to organize the admin panel by grouping related resources together.

5. permit_params :...

• Specifies the parameters allowed to be mass-assigned through the ActiveAdmin interface. This includes attributes like store_id, airdrop_type, name, description, blockchain, token_symbol, currency, exchange_rate, status, active, completed_at, and recipients_csv.
• This ensures only permitted attributes can be modified, protecting against mass-assignment vulnerabilities.

6. action_item :admin_send_airdrop_tokens, only: :show do ... end

• Adds a custom action button to the show page for sending airdrop tokens to recipients.
• The button is only shown if the Airdrop is in a pending state and is active.
• The button is labeled "Send Tokens to Airdrop Recipients" and links to a custom action (admin_send_airdrop_tokens).

7. member_action :admin_send_airdrop_tokens do ... end

• Defines a custom action for sending airdrop tokens.
• Calls the send_airdrop_tokens method on the Airdrop model, which likely handles the process of distributing tokens to recipients.
• Sets a flash message "Sending airdrop tokens to recipients has been scheduled" and redirects back to the show page for the Airdrop.

8. form html: { multipart: true } do |f| ... end

• Customizes the form for creating and editing Airdrop records.

• The form is configured to support file uploads (multipart: true).

  The form is divided into several panels:

• Airdrop Status:

  • Inputs for status (a dropdown with the AIRDROP_STATUS options) and completed_at (a datepicker for selecting the completion date).
  • The datepicker is restricted to dates from the previous day up to the current date.

• Airdrop Info:

  • Inputs for airdrop_type (a dropdown with AIRDROP_TYPES), name, store (a dropdown with active stores), description, blockchain (a dropdown with blockchain options), token_symbol (a dropdown with cryptocurrency symbols), currency (a dropdown with currencies, here only 'USD'), exchange_rate, and active.
  • The form also includes some descriptive text (para) to guide the admin on how to fill in the fields, especially concerning the exchange_rate.

• Airdrop Recipients:

  • A file input (recipients_csv) for uploading a CSV file containing the airdrop recipients.
  • The panel includes instructions on how to format the CSV file, specifying the required headers (participation, ref1, balance, wallet_address, token_balance).

Summary:

• This file configures the ActiveAdmin interface for managing Airdrop records, including customizations for the form, listing, and actions.
• It provides a way to send tokens to airdrop recipients via a custom action, ensuring that only active and pending airdrops can initiate this process.
• The form is carefully structured to collect all necessary data for an airdrop, including file uploads for recipient data and options for setting the status, blockchain, and other important fields.

This setup offers a comprehensive and user-friendly interface for managing airdrop campaigns within the application, with all necessary controls and validations in place.