Release Current Release: Version 2.5.0 · luozongbao/myapis

Current Release: Version 2.5.0

Release Date: September 2, 2026
Status: Stable Release

Released: September 2, 2026

Dynamic vCard builder for the QR Code Generator — add/remove
unlimited name variants, nicknames, emails with custom
types (WORK / HOME / INTERNET), and phones with custom
types (CELL,VOICE / WORK,VOICE / HOME,VOICE / FAX / VOICE)
Shared-hosting deployment guide for Hostinger / cPanel /
SiteGround / Namecheap with public/config.php analytics fallback
Pluggable visitor tracking (Umami + GA4) extended with a
shared-hosting-friendly config.php fallback and shipped in
every public page
Single-source env configuration via example.env tracked in
the repo for Docker / production deployments

Dynamic name fields
(api/qr-code-generator/index.php,
public/qr-code-generator.php):
- Add/remove unlimited structured names (formatted,
  prefix, first, middle, last, suffix) — each rendered
  in the right order in the generated vCard
- Optional kind selector (Individual / Organisation /
  Group) so the same UI works for personal and business cards
Dynamic nickname fields
- Add/remove unlimited nickname[] entries rendered as
  NICKNAME:nick1,nick2,...
Dynamic email types
- Each row now carries its own type dropdown
  (WORK / HOME / INTERNET) instead of a single hard-coded
  prefix
- Backward-compatible: legacy work_email / home_email fields
  still accepted when no dynamic rows are present
Dynamic phone types
- Each row now carries its own type dropdown
  (CELL,VOICE / WORK,VOICE / HOME,VOICE / FAX / VOICE)
- Backward-compatible: legacy work_phone / home_phone /
  cell_phone / fax fields still accepted
Backend collection helper (collectDynamicItems()):
- Reads both $_GET and $_POST
- Re-indexes dynamic rows server-side so missing/empty entries
  do not break the vCard output
- Merges with legacy single fields so existing API consumers are
  unaffected

Moved the QR Code Generator documentation into
api/qr-code-generator/README.md
so the API folder is self-describing
Removed the legacy docs/nginx-conf/*.conf and
docs/requirements/myapi-2.0.md files — they were stale and are
now superseded by the Shared Hosting Deployment guide in the
project root README

Tracked example.env: ships a fully-commented
copy of every environment variable the stack understands (ports,
PHP limits, timezone, analytics provider, Umami / GA4
credentials). Update .gitignore so it does not exclude the
example file — .env itself remains git-ignored.

New public/analytics.php partial:
- Mirrors the Docker analytics.php snippet logic so non-Docker
  / shared-hosting deployments get the same tracking output
- Tries to require_once public/config.php (or config.php
  next to the partial) before reading env vars — shared
  hosting providers that do not support .env or
  auto_prepend_file can still configure analytics
- JSON / API responses are still excluded automatically
public/config.php.example: copy /
edit template that calls putenv() for Umami or GA4
Every page under public/ now includes
public/analytics.php so the snippet is
present on every tool page without manual edits

api/qr-code-generator/index.php — dynamic vCard collection
api/qr-code-generator/README.md — moved per-tool docs here
public/qr-code-generator.php — dynamic name / nickname / email
type / phone type UI
public/analytics.php — new shared-hosting analytics partial
public/config.php.example — new shared-hosting analytics
template
public/*.php (every tool) — include analytics.php
public/api-specs/*.php — include analytics.php
example.env — now tracked (no longer git-ignored)
.gitignore — exclude only .env, not example.env
docker/php/analytics.php — read shared-hosting config.php first
README.md — new Shared Hosting Deployment section, env table
update, Latest Updates bump
RELEASE.md — this entry
Removed docs/nginx-conf/lab01.conf … lab04.conf
Removed docs/requirements/myapi-2.0.md

php -l passes for every modified PHP file
QR Code Generator vCard output verified end-to-end via Docker:
- Multiple structured names render in the expected order
- Multiple nicknames collapse into a single NICKNAME: line
- Email / phone types appear with the chosen prefixes
Analytics:
- curl -s http://localhost:8080/ | grep -E 'umami|gtag' →
  returns the matching <script> tag when enabled
- curl -s http://localhost:8080/api/health-calculator/ | grep -E 'umami|gtag'
  → returns nothing (API paths are excluded)
- On shared hosting: drop a public/config.php that sets the
  provider via putenv(), hit any tool page, view-source, and
  the matching <script> tag is present
example.env is committed, .env is still git-ignored