Vendors & Farms¶
Menu Location: Products > Vendors & Farms
Overview¶
Vendors & Farms is where you record "the individual farms or companies that make or grow a product." It's a simple profile list, not a purchasing or supplier-management system: there are no payment terms, purchase orders, delivery schedules, cost tracking, or performance ratings on this page.
Its purpose is to let customers know where your products come from. Each entry can carry a name, logo, description, website, and location, and can be shown on one of two public pages depending on whether it's marked as a Farm or a Vendor:
- Farm-type entries appear on your public Farms page
- Vendor-type entries appear on your public Vendors page
Both public pages are opt-in, and are turned on/off separately from Products > (wrench/settings icon) > Settings, using the "Show Farms Page" and "Show Vendors Page" toggles.
A product is connected to a vendor/farm from the product's own edit screen, using its "Vendor/Farm" dropdown. Once a product has a vendor/farm linked to it, that information becomes visible in the shop and on the customer's order view.
Primary Functions:
- Add and manage farm/vendor profiles (name, logo, description, website, location, food miles)
- Mark each entry as a Farm or a Vendor to control which public page it appears on
- Control the display order farms/vendors appear in on the front end
- Set a weekly order cutoff for a vendor's products (protects vendor lead time)
- Soft-delete (and restore) entries you no longer use
- Bulk-import vendor/farm records via CSV
Page Layout¶
List View¶
- Add button, create a new vendor/farm record
- Import icon, CSV import of vendor/farm records (
admin-import.php) - Set Display Order button, opens the sort tool used to reorder how entries appear on the front end
- Show Deleted / Hide Deleted toggle, reveals soft-deleted entries, shown with a red row highlight and a Restore button
The list itself shows each entry's Name, its Visible on/off status, and its Url (page slug), plus the usual edit and delete/restore action icons. There is no dedicated search box on this page, you browse the list directly.
Vendor/Farm Edit Screen¶
When adding or editing an entry, the available fields are:
| Field | What it's for |
|---|---|
| Name | The farm or vendor name |
| The email address of the farm/vendor (optional) | |
| Phone | The phone number of the farm/vendor (optional) |
| Logo | A logo image (jpg, png, or gif), max 250×250px (optional) |
| About Us | A description of the farm/vendor, whatever you want customers to read about it |
| Website | A URL, e.g. http://www.thefarmwebsite.com (optional) |
| Location | The address of the farm/vendor, a single free-text field, not separate street/city/state/zip fields (optional) |
| Food Miles | How many miles the product has to travel from the farm/vendor to your warehouse |
| Visible | Whether this entry shows on the front side |
| Farm or Vendor | Determines which public page (Farms vs. Vendors) the entry displays on; leave as "Farm" if you haven't enabled the Vendors page |
| Display Order | Controls the entry's position on the public Farms page |
| Url | The page slug, auto-generated from the name (editable) |
| Verified | A plain numeric field with no explanation text in the admin form; not shown on the customer-facing pages |
| Turn on an order cutoff | Enables a weekly order cutoff for this vendor's products (see Order Cutoff below) |
| Cutoff Day | The day of the delivery week the cutoff falls on (weeks start Sunday). Only used when the order cutoff is on |
| Cutoff Hour | The hour of the cutoff. Only used when the order cutoff is on |
| Cutoff Minute | The minute of the cutoff. Only used when the order cutoff is on |
Order Cutoff¶
Each vendor can have a weekly order cutoff, a day-of-week and time (e.g. "Sunday, 9pm") past which customers can no longer add that vendor's products to an order shipping for that delivery week. This is useful for vendors with production lead times, such as a bakery that needs advance notice.
- Turn it on with the vendor's "Turn on an order cutoff" field, then set Cutoff Day, Cutoff Hour, and Cutoff Minute
- While the cutoff is still open, the vendor's public page shows a "Super Fresh Deadline!" callout telling shoppers when it closes
- Once the cutoff passes for a delivery week, the vendor's products can no longer be added to an order shipping that week in the customer shop, and the shop grid shows a "deadline passed" note explaining why and when it reopens; items already in the order can still be decreased or removed
- As the cutoff approaches, the shop shows a "only N hours to order" countdown badge on that vendor's products
- A single product can be given its own cutoff instead of inheriting the vendor's, using the "Override vendor order cutoff" option on the product's own edit screen (see Add Product page)
Creating a Vendor/Farm Profile¶
Steps:
- Click "Add"
- Enter the Name and save: the quick-add form only asks for Name (plus Visible and Url, which default sensibly)
- Reopen the new entry to fill in the rest: Logo, About Us, Website, Location, Food Miles, and whether it's a Farm or a Vendor
- Set Visible on when you're ready for customers to see it
- Save
Linking a Product to a Vendor/Farm¶
Products are connected to a vendor/farm from the product's own edit screen, using its "Vendor/Farm" dropdown, not from this page. Once a product has a vendor/farm selected, that association shows up in the shop and on the customer's order view.
Displaying Vendors/Farms to Customers¶
For an entry to actually show up on your site:
- Its Visible field must be on
- The matching public page must be enabled: Products > (wrench/settings icon) > Settings, "Show Farms Page" for Farm-type entries or "Show Vendors Page" for Vendor-type entries
- Its Farm or Vendor field must match the page you expect it to appear on
What customers actually see: the About Us text, Logo, Website link, and, when set, a "Food Miles: [X] miles" line built from the Food Miles field.
Common Use Cases¶
Use Case 1: Add a New Local Farm¶
Goal: List a new farm supplier on your site
Steps:
- Click "Add", enter the name, e.g. "Sunrise Organic Farm," and save
- Reopen the entry
- Add a logo, an About Us description, website, location, and food miles
- Leave Farm/Vendor set to "Farm"
- Turn on Visible
- Confirm "Show Farms Page" is on under Products > Settings
Use Case 2: Update a Farm/Vendor's Description or Photo¶
Goal: Refresh the customer-facing info for an existing entry
Steps:
- Find the entry in the list and open it
- Update the About Us text and/or replace the Logo
- Save
Use Case 3: Temporarily Remove a Farm/Vendor from the Site¶
Goal: Stop showing an entry without deleting its record
Steps:
- Open the entry
- Turn off Visible
- Save
Use Case 4: Link a Product to a Farm/Vendor¶
Goal: Show customers where a specific product comes from
Steps:
- Edit the product (not the vendor/farm)
- Select the farm/vendor from the "Vendor/Farm" dropdown
- Save the product
Use Case 5: Reorder Farms on the Front End¶
Goal: Change the order farms appear in on the public Farms page
Steps:
- Click "Set Display Order" from the Vendors & Farms list
- Reorder entries
- Save
Troubleshooting¶
Cannot Find a Vendor/Farm¶
Check:
- Verify the spelling of the name
- Click "Show Deleted", it may have been soft-deleted rather than removed
- There's no search box on this page, so browse the full list
Vendor/Farm Not Showing on the Site¶
Check:
- Visible must be turned on for that entry
- "Show Farms Page" or "Show Vendors Page" (whichever matches its type) must be turned on under Products > Settings
- The entry's Farm/Vendor type must match the public page you're checking
Product Doesn't Show a Vendor/Farm¶
Solutions:
- Edit the product and select an entry from its "Vendor/Farm" dropdown, this is set on the product, not on the vendor/farm page
- Confirm the vendor/farm entry itself is Visible
Related Pages¶
- Products (
product_classifications_active.php): enable/disable the public Farms/Vendors pages from the wrench/settings icon, and set a product's Vendor/Farm from the product edit screen - Distributors: a separate page/table for wholesale supplier records, unrelated to this customer-facing Vendors & Farms list
Best Practices¶
Vendor/Farm Setup¶
- Fill in About Us, Logo, Website, and Food Miles before turning Visible on, these are the fields customers actually see
- Keep the logo within the 250×250px limit
- Pick the correct Farm vs. Vendor type so the entry lands on the page you expect
Housekeeping¶
- Turn off Visible (or soft-delete) entries you no longer use instead of leaving stale profiles live
- Use "Set Display Order" to control how farms are ordered on the front end
- Use "Show Deleted" if you need to recover a removed entry
Quick Reference Card¶
| Task | Action/Location |
|---|---|
| Add a new vendor/farm | Click "Add" |
| Edit vendor/farm info | Click the entry, then edit |
| Import vendors/farms in bulk | Import icon (CSV) |
| Reorder farms on the front end | "Set Display Order" button |
| Hide a vendor/farm from customers | Edit entry > turn off Visible |
| Remove a vendor/farm | Delete icon (soft-delete) |
| Recover a removed vendor/farm | "Show Deleted" > Restore |
| Link a product to a vendor/farm | Edit the product > "Vendor/Farm" dropdown |
| Turn on the public Farms/Vendors pages | Products > wrench icon > Settings |
FAQs¶
What's the difference between "Farm" and "Vendor"?¶
It's just the Farm or Vendor field on the entry. Farm-type entries show on your public Farms page; Vendor-type entries show on your public Vendors page. If you haven't enabled the Vendors page, leave entries set to "Farm."
Do customers actually see this information?¶
Yes, when the entry is Visible and the matching public page (Farms or Vendors) is enabled. Customers see the About Us text, logo, website link, and food miles, not any internal-only fields.
How do I connect a product to a specific farm/vendor?¶
Edit the product itself and choose the farm/vendor from its "Vendor/Farm" dropdown. This isn't done from the Vendors & Farms page.
How do I control the order farms appear in on the site?¶
Use the "Set Display Order" button on the Vendors & Farms list.
Can I delete a vendor/farm?¶
Deleting soft-deletes the entry (it's hidden from the normal list and marked deleted, not removed from the database). Use "Show Deleted" to find it again and Restore it if needed.
The public Farms/Vendors page isn't showing on my site, why?¶
Check that "Show Farms Page" / "Show Vendors Page" is turned on under Products > (wrench/settings icon) > Settings, and that the individual entries you expect to see are marked Visible.
Recent Updates¶
2026-08-11¶
- The vendor cutoff deadline is now shown to shoppers as a "Super Fresh Deadline!" callout on the vendor's public page and on product detail pages, and the past-cutoff message in the shop grid was rewritten to a shorter "deadline passed" note
2026-08-07¶
- New: vendors can now have a weekly order cutoff (day-of-week + time). Past the cutoff, that vendor's products can no longer be added to an order shipping the affected delivery week, and the shop shows an "only N hours to order" countdown as it approaches. A single product can override its vendor's cutoff from the product's own edit screen
End of Documentation
For additional help, contact your system administrator or Kiva Logic support.