Customer Requirement

The client requires a feature within the auction system to handle scenarios where an auction ends without a winning bidder. The main requirement is that unsold auction items should not remain inactive but instead be moved into a “Buy Now” category, allowing them to still be available for purchase by interested buyers.

🔹 Key Features & Tasks

1. When an auction ends without a winner, The item must transition to a “Buy Now” format, either automatically or manually, to maximize the chances of sale.
2. Sellers should have flexibility in deciding how the item should be handled after the auction ends (automatic vs manual control).
3. The system should provide a smooth, seller-friendly process to manage this flow without requiring complex steps.

Design & Development

• Implementation Options : To fulfill the requirement of moving unsold auction items to a “Buy Now” category, we propose two implementation approaches. Each option provides different levels of automation and seller control:

• Automatic Move to Buy Now
  • During auction item creation, the seller is presented with an additional checkbox: “After auction end, if the item is not sold, automatically list with Buy Now price.”
  • If this option is selected, the system will automatically transfer the item to the “Buy Now” category once the auction ends without a winning bidder.
  • The item will retain the Buy Now price defined at the time of auction listing 
  • This approach minimizes manual intervention and ensures that items are continuously available for purchase.

Estimated Effort for all pages = 13 hours

• Manual Move to Buy Now
  
  • Once an auction ends without a winner, the seller will have the option to manually move the item into the “Buy Now” category.
  • The seller can access this option via their dashboard under the auction management section.
  • This approach provides the seller with full control over what happens after the auction ends, while still enabling the item to be resold quickly.

Estimated Effort for all pages = 8 hours

Effort

Estimated Effort = 21 hours

Commercials

• Project Cost

• Total Cost
  • Total Ball Park Effort for Development will be 21 hours
  • Our hourly rate is USD 45/hour

21 hours x USD 45/hour = USD 945

Customer Requirement

1. Registration Fields List
   • Objective
     • Enhance the WooCommerce registration process by adding custom dealer-related fields, ensure they are editable in the user’s profile, and display them in the WordPress admin panel for administrators.
     • Fields to Add
       • What kind of dealer are you? (Dropdown / Text field – confirm requirement)
       • Phone Number
       • Dealer Name
       • Dealer Address
       • Dealer Number
       • Federal Tax ID #
       • Primary Contact Email Address (separate from WordPress login email if needed)
       • Password (default WooCommerce registration field)
     • Scope of Work
       • Add Fields to Registration Form
         • Hook into woocommerce_register_form to display additional fields.
         • Add proper labels, placeholders, and validation (e.g., required fields).
         • Ensure sanitization before saving user meta.
         • Store values in usermeta on successful registration.
       • Add Fields to User Profile (Frontend / My Account)
         • Display these fields under My Account → Account Details or a custom tab.
         • Make fields editable so users can update their details.
         • Add validation/sanitization on save.
       • Add Fields to Admin → User Edit Screen
         • Hook into show_user_profile and edit_user_profile to display dealer fields.
         • Allow admin to edit/update these fields.
         • Save changes on personal_options_update and edit_user_profile_update.
       • Backend Data Handling
         • Store all custom fields in usermeta.
         • Ensure compatibility with WooCommerce functions.
         • Make sure fields are exportable via WooCommerce → Export Customers if needed.
     • Deliverables
       • Fully functional WooCommerce registration form with custom fields.
       • Custom fields visible & editable in:
         • Frontend: Registration & My Account.
         • Backend: Admin → Users → Edit User.
     • Secure validation & sanitization for all inputs.

 Development Effort = 3 hours

2. Promo Code for Seller (First 10 Listings Free)
   • Promo Code Generation & Distribution
   • On user registration:
     • Auto-generate a unique promo code for each seller OR assign a global promo code (e.g., FREE10).
     • Send the promo code via email to the seller.
     • Store the promo code in user meta for tracking.
     • Show promo code on seller dashboard.
       
   • Checkout Page: Apply Promo Code
     • Add a promo code input field on the listing payment page.
     • When entered, validate:
       • Is it assigned to this seller?
       • Is it unused or within allowed quota (10 listings)?
     • If valid → Apply discount (free up to 10 listings).
   • Admin Controls
     • See promo codes assigned to sellers.
     • Track remaining free listings.
     • Reset or reassign promo codes.

Development Effort = 7 hours

3. Feature: Payment Flow & Invoice Generation After Auction End
   • Buyer Invoice
     • Trigger: When auction ends, check highest bidder (winner).
     • Invoice Generation:
       • Auto Create a WooCommerce “Order” for the winning user.
       • Include auction item details (title, description, final price).
       • Add Buyer’s Premium (BP) if applicable.
         
     • Delivery:
       • Send invoice via email (PDF or WooCommerce order email).
       • Show invoice in Buyer’s Dashboard → My Invoices/Orders.
         
   • Seller Invoice
     • Create seller payout report / invoice.
     • Show sold item details: Item name, final auction price.
       • Delivery:
         • Send seller invoice via email.
     • Show invoice in Seller Dashboard → My Invoices/Sales.

Development Effort = 10 hours

Effort

• Estimated Effort = 20 hours

Commercials

1. Project Cost

• Total Cost
  • 20 hours x USD 45/hour = USD 900
  • Discount 10% – Final Cost : USD 810

Customer Requirement

Requirement 1 :Importing Car Makes and Models Using API-Ninjas Cars API

Implementation Details:

Integrate the API-Ninjas Cars API to dynamically import all car makes and their models as hierarchical taxonomy terms in car_models (parent: makes, children: models).

• Use the API endpoint: GET https://api.api-ninjas.com/v1/cars with parameters like make, model..
• Authentication: Requires an API key via header X-Api-Key. Assume the user will provide the key; store it securely in WordPress options or environment.
• Fetch all makes first (by querying without make parameter or using a list of known makes, then fetching models per make).
• For each make (e.g:  Bugatti, BMW, etc.), fetch models and insert as child terms using wp_insert_term() with parent set to the make’s term ID.
• Run as a one-time import function hooked to init, with a flag to prevent duplicates (using term_exists()).

Development Effort: 5 hours

Effort

• Estimated Effort = 5 hours

Commercials

1. Project Cost

• Total Cost
  • 5 hours x USD 45/hour = USD 225
• Final Discounted Cost
  • USD 225