Site Specific

Site-Specific Features (The Lunch Box)

A few features are unique to The Lunch Box and are not on the Chef Ann Foundation site. They’re built and maintained by development:

• Recipes (HealthePro) — the school-recipe system is fed by the HealthePro API/JSON. Recipe overview and detail pages are generated from that data (see the Recipes section below and the “API Documentation” page).
• The searchable resource sections specific to TLB — Supporting Research, Menu Cycles, Webinars & Trainings, Project Produce, and the Management / Procurement / School Breakfast / Salad Bars tools & resources.

The Chef Ann Foundation site has its own unique features that TLB does not use — an Event Calendar (Solspace Calendar plugin) and the Blog / Press Room / Home Recipes / Resource Library content types. Don’t expect those here.

 

Training Videos

Below is access to the training videos captured during your training session.

• Part 1a: Video link here
• Part 1b: Video link here
• Part 1c: Video link here
• Part 2: Video link here
• Part 3: Video link here
• Part 4: Video link here
• Part 5: Video link here

(A chapter-by-chapter topic index for each part was captured during training; ask your team if you need the timestamped breakdown.)

 

Module Stack

For reference, the Full Module List page shows the modules you can build a page with.

 

Secondary Navigation

The secondary (in-page) navigation appears automatically when a page has 3 or more H2 headings. On pages where you don’t want it (such as a top-level “Overview” page), turn it off:

1. Open the page entry.
2. Select the Meta tab below the page title.
3. Set Meta — Subheader Anchors to Disabled.
4. Save.

 

Recipes (HealthePro)

The Lunch Box’s school recipes are unique: everything about a recipe — its name, image, category, attributes, allergens, ingredients, instructions, meal-pattern and nutrition figures — comes from the HealthePro recipe system, not from Craft entries. There is nothing to edit for an individual recipe in this Craft back end.

How recipes reach the site

The site keeps its own copy of the recipe list and refreshes it from HealthePro once an hour. That copy powers the recipe search page — the keyword search, the Category / Attributes / Allergens filters, and the card and table views — so searching is fast and keeps working even when HealthePro is slow. Individual recipe detail pages, the “Scale Recipe” button and the PDF/Excel exports talk to HealthePro live every time.

Editing an existing recipe

Make the change in HealthePro — copy, image, category, attributes, allergens, yield, ingredients, all of it. The recipe’s detail page shows the change as soon as HealthePro has it; its card on the search page updates at the next hourly refresh. Contact the Chef Ann Foundation team for HealthePro access.

Recipe images are managed in HealthePro too. (They used to be uploaded to Craft under Assets → Recipe Images; that is no longer how it works — an image placed there has no effect.) If a recipe has no image in HealthePro, the site shows a generic recipe illustration.

Adding a new recipe

Create the recipe in HealthePro and mark it active. Its detail page is available right away at its HealthePro recipe number; its card appears on the search page after the next hourly refresh (so within about an hour).

Retiring a recipe

Mark the recipe inactive in HealthePro. Its detail page starts redirecting to the recipe index immediately, and its card drops off the search page at the next hourly refresh. Recipes are never deleted from the site — they simply follow HealthePro’s active/inactive status.

Recipe page performance

If HealthePro is slow or down, recipe detail pages, scaling and exports are affected; the search page keeps working from the site’s own copy (the Category filter may come up empty). When ingredient data can’t be fetched, the detail page shows a note and the PDF/Excel downloads are temporarily unavailable. There is a status page for uptime monitoring — see the “API Documentation” page.

Note: Recipes were previously powered by the OneSource/Horizon system. Old recipe links (the letter-and-number codes such as “DR008”) redirect automatically to the matching HealthePro recipe, so existing bookmarks and printed materials keep working.

 

Featured Entries (SiteSearch) Module

This module lets you capture a search from one of the searchable sections and display its results on another page. (It was formerly called “Featured Entries (Reliquary)”; it now runs on the SiteSearch module — see the “SiteSearch” page.)

To set it up:

1. Add the Featured Entries (SiteSearch) module to the page.
2. Fill in the Heading (the H2 shown on the front end).
3. Fill in the Button text and Hyperlink if you want a call-to-action button.
4. On the front end, go to the index page for the content you want (e.g. Project Produce), run the search/filter you want to feature, and copy the search blob from the URL — the long string after s=.
5. Paste that string into the module’s Search URL field.
6. In the Group ID field, enter the SiteSearch group handle for that content (see the list below). (Unlike the old Reliquary workflow, this is a short text handle — there is no longer a /cube/reliquary/groups lookup screen.)
7. In Max Results, enter how many entries to show (keep it to multiples of 3).
8. Save and check the front end.

SiteSearch group handles on this site:

Content	Group handle
Site-wide search	global
Supporting Research	supportingResearch
Menu Cycles	menuCycles
Webinars & Trainings	webinarsAndTrainings
Project Produce	projectProduce
Management Tools & Resources	managementToolsResources
Procurement Tools & Resources	procurementToolsResources
School Breakfast Tools & Resources	schoolBreakfastToolsResources
Salad Bars Tools & Resources	saladBarsToolsResources

(The schoolDistricts group powers the district-finder typeahead, not featured entries. Handles are defined in modules/SiteSearch/config.php — ask development if you need one that isn’t listed.)

 

Featured Entries (Manual) Module

Adds specific entries you choose from anywhere on the site:

• Add the Featured Entries (Manual) module.
• Fill in the Heading, and the Button text / Hyperlink if desired.
• Use + Add an entry to pick the entries to feature (up to three).

 

Featured Entries (Automatic) Module

Populates automatically from a section:

• Add the Featured Entries (Automatic) module.
• Fill in the Heading, and the Button text / Hyperlink if desired.
• Choose the source section: Supporting Research, Menu Cycles, Webinars & Trainings, Project Produce, Global Search, or the Management / Procurement / School Breakfast / Salad Bars tools & resources.
• Choose the order: Ascending, Descending, or Random.
• Set the max number of results (keep it to multiples of 3).

 

SEO

Open a page’s SEO tab (below the page title) to manage its search/social metadata (powered by the SEOmatic plugin).

• Title — auto-populates from the entry’s title; this is the page title users see.
• SEO Title Source — leave alone unless you need to override the title for search results.
• SEO Description Source — when filled in, this text can appear under the title in search results and in the site’s own search cards.
• SEO Global Social Media Image — the default share image for social cards. To change the global default: open SEOmatic → Global SEO → SEO Image Source, remove the current image, upload a new one, and Save. Individual pages can have their own custom social image.

 

Affiliate Pop-up

The affiliate pop-up triggers when any of these conditions are met (after which a flag is set in the visitor’s browser so it doesn’t show again):

• More than 30 seconds spent on the homepage (cumulative across visits).
• Visiting 3 “generic” pages (pages using the standard Page template — not recipes).
• Downloading 3 files (anything served from the storage bucket or app server — a JPG poster, a PDF, etc.).
• Viewing 3 “special” pages (a recipe detail or a Project Produce/case-study entry increments this counter).

 

“Text Banner” Module

To show this module with reversed (white) text, choose one of the Background Color options in Advanced options (any option except the two “Gray” ones).

 

Modules with a Background Color

When building a page, alternate modules that have a background color with modules that don’t — it gives readers a visual break as they scroll. For example: start with a module set to “Dotted Gray,” follow with a few plain (white) modules, then a module set to “Dotted Teal.”

Avoid stacking differently-colored modules directly on top of each other: it’s visually heavy, large amounts of reversed type are hard to read, and jumping between colors works against the page design.

 

Image Usage Tips

When to use which image/module, with helpful padding amounts:

• Primary section overview pages (e.g. Management Overview, Procurement Overview) should use the Image Banner module at the top (see image sizes below).
• Secondary overview pages that introduce tertiary pages beneath them should also use the Image Banner module at the top.
• Regular secondary & tertiary pages should open with the Image and Text module, image first, containing:
  • A “square-ish” image (see sizes below)
  • An H1 with the page name
  • An intro paragraph in the “Large Type” style
  • Suggested Advanced options: Larger: Equal · Vertical Alignment: Top · Text First: off · Width: Auto Extended · Outer Top: 0 · Inner Top: 4 · Inner Bottom: 4 · Outer Bottom: 0 · Background Color: Dotted Gray · Background Position: Center Center
  • The next module typically uses Outer Top: 2 and Inner Top: 0.
• To promote the next page in a section, end the page (just before the footer “Supporters” area) with an Intro Image & Text (Outer Bottom: 0), Promos Simple, or Promos Featured module.
• The Image & Text With Link Grid module should use a taller, vertical image.
• For a large image at the top of a page, prefer the Image Banner module over the Image module (Outer Top & Inner Top: 0).
• To break up content quickly, use the Illustration Banner module with the “Illustration-Banner.jpg” asset (in Assets → Images).

 

Module Padding Tips

• For a module with a background color: Outer Top: 0 · Inner Top: 4 · Inner Bottom: 4 · Outer Bottom: 0. The modules before and after it typically use Outer Top / Outer Bottom: 3.
• For the Image Banner module at the top of a page: Outer Top: 0 · Inner Top: 0 · Inner Bottom: 0 · Outer Bottom: 0. The next module typically uses Outer Top: 2, Inner Top: 0.
• The Intro Image & Text and Image and Text With Link Grid modules let the image break out of the background, so use Outer Top: 0 · Inner Top: 0 · Inner Bottom: 0 · Outer Bottom: 0. The module before typically uses Outer Bottom: 1–2; the module after typically uses Outer Top: 3.

 

Image Sizes

Use 72dpi and save for web as a JPG of 350kb or less.

Banners & Promos

1. Homepage Banner — 3000 × 1500 px
2. Interior Banner — 3000 × 875 px
3. Square-ish Promos/Images — 1236 × 1170 px
4. Rectangle Promos/Images — 1236 × 850 px
5. Staff / Board headshots — 1236 × 1170 px

Module-specific

1. Image and Text With Link Grid — 1236 × 1512 px
2. Image module — 3000 × 1400 px
3. Illustration Banner module — 3848 × 800 px (use “Illustration-Banner.jpg” in Assets → Images)
4. Text module — 3000 × 875 px
5. Stats module — 3848 × 1310 px

Need to crop/compress quickly? befunky.com/create is a free option.

 

Supporter Logo Size

72dpi, saved for web as a transparent PNG; center and size each logo relative to the others (don’t fill the whole space). Footer “Supporters” logos should be reversed to white.

• 800 × 320 px

 

Illustration Sizes

Vector, saved for web at 72dpi (JPG; or transparent PNG for transparent backgrounds — don’t fill the whole space).

1. Square-ish illustrations — 1236 × 1170 px
2. Rectangle illustrations — 1236 × 850 px

 

Icon Sizes (Card/Tile pages)

Vector, saved as SVG; center and size each icon relative to the others (don’t fill the whole space).

• 56 × 56 px

 

Icon Designations

Which icon appears on a card or tile is chosen automatically from the entry’s topic / media type / project type. For reference:

Supporting Research (Topics) — Case Studies = book w/ bookmark · District Innovations = light bulb · Facilities = house w/ leaf · Farm to School = pig · Finance = $ in circle · Marketing = ABC w/ 3 bars · National School Breakfast Program = apple · National School Lunch Program = fork & spoon · Nutrition Education = 3 book spines · Policy = building w/ 3 columns · Preschool = school bell · Procurement = shopping cart w/ plus · Recipes = pencil w/ paper · Research = open book · Salad Bars = leaf · Training = pull-down screen w/ up chart · USDA = USDA text in circle · Default = star

Webinars & Trainings (Media Type) — Video/YouTube = film reel w/ play · Photo = image icon · PDF = PDF icon · Audio = sound icon · Default = star

Project Produce (Project Type) — Rainbow Day = rainbow · Tasting = fork & spoon · Farmer Visit = wheat · Chef Demonstration = apron · Farmers Market = basket · Health Fair = leaf · Harvest of the Month = ribbon · After School Snack = apple · Default = star

Misc. (available, not on any page) — Excel = .XLS icon · Word = .DOC icon · External Link = link icon