Social Contact Footer v1.0.0

Social-media icons and a blog link for the Zen Cart storefront footer, with an
optional newsletter signup underneath.

Runs on Zen Cart v1.5.8 through v3.0.0 and PHP 7.4 through 8.5 from a
single codebase. No template file is edited or overridden, and nothing is
dropped into your admin/ or includes/ directories.

Install

Download the zip below, unzip it, and copy the zc_plugins/SocialContactFooter/
directory into the zc_plugins/ directory of your store. Then
Admin → Modules → Plugin Manager → Install.

The master switch is off on a fresh install, so nothing reaches your
storefront until you have set the block up and switched it on. Plugin Manager
shows Mod Not Turned On beside the plugin name until you do.

Full instructions are in docs/INSTALL.md, and every setting is documented in
the offline manual (readme.html), reachable from a Read Me button in
Plugin Manager before you install.

Storefront

• Twenty networks, each icon hidden until you supply a link.
• Link fields take only the distinguishing part of an address — YourPageName,
  not the whole URL. A full address still works where a profile does not fit
  the usual pattern.
• The contact icon needs no entry at all: your store already knows its own
  Contact Us page and owner address.
• On-site links are preferred throughout, because a relative address survives a
  domain change and an http-to-https move.
• Blog line with the wording built from your store name.
• Separate desktop and mobile icon sizes, four badge shapes, brand / monochrome
  / inherited colour, alignment, display order, link target, optional block
  background.
• A real stylesheet your template can override by supplying its own copy.

Newsletter

• Double opt-in, not optional. Nothing is sent, no customer account touched
  and no owner notice until the confirmation link is clicked.
• Neither mail format is pre-selected, and that is not configurable —
  pre-selecting one is not lawful in the US. Enforced server-side as well as in
  the markup.
• The Subscribe button appears only once an address is entered and a format
  chosen, as progressive enhancement so the form still works without
  JavaScript.
• The visible radio indicator is drawn by the stylesheet, because Zen Cart
  templates commonly hide native radios; the real input is retained for
  submission, focus and screen readers.
• Honeypot plus dwell-time spam trap.
• Two audiences are registered in the Newsletter Manager, so subscribers
  without a customer account are reachable — stock audience queries read the
  customers table alone and cannot see them.
• Every subscriber-facing message carries a permanent unsubscribe link and asks
  the reader to whitelist your sending address.
• No image on these emails unless you add one — not even your store
  logo. You can upload a header image of your own from the subscribers page
  (550 × 110 is the size to aim for); it applies to these three messages
  only, and your store's own header file is never touched.

Admin

Tools → Footer Newsletter Subscribers

• Filter, search, change status, delete, export CSV including each subscriber's
  unsubscribe URL.
• CSV import for addresses collected on paper, with a printable sign-up
  sheet included. Imported people are created pending and sent the same
  confirmation request the footer form sends — there is no way to bulk-import an
  already-subscribed person.
• Invite Registration — invite confirmed subscribers with no account to
  create one. They receive a password and a single link that activates the
  account and lands on the login page; the account is unusable until they follow
  it. A re-send is offered while it is still pending.

Accessibility

Checked against WCAG 2.1 AA rather than assumed: contrast computed from the
declared colours, real form semantics, landmarks and table structure on the
admin pages, and a 1.2rem floor on admin text. One documented deviation — four
brand badges use white glyphs on light official colours; the Monochrome and
Inherit icon styles resolve it.

Verified before release

58 core Zen Cart symbols checked against all six release branches. Lint plus
105 harness runs across PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 and 8.5, clean at
E_ALL.

Support

Questions and general help:
Forum Support Thread
at zen-cart.com. Something broken:
open an issue.

GPL-2.0. The bundled icon glyphs are simplified original drawings, not the
official brand logos.