Repository navigation
Releases
v1.0.0 — Hashtag Generator (stripped open-source version)
Release notes — Altus Hashtag Generator v1.0.0 (stripped open-source version)
First public release of the Altus Hashtag Generator as a free WordPress plugin.
What it does
Pick your trade, add your town, choose what the post is about, and get 20–28 ready-to-copy Instagram hashtags in seconds — niche tags that reach buyers, location tags that reach locals, and UK small-business tags that reach your community. All generated in the visitor's browser; nothing entered ever leaves their device.
In this release
- 24 business types with curated niche tags: plumber, electrician, estate agent, café, restaurant, takeaway, bakery, beauty salon, barber, hair salon, personal trainer, accountant, builder, painter, cleaning, florist, gardener, photographer, solicitor, dentist, pet groomer, garage, wedding venue, interior designer.
- 12 post topics: general, behind-the-scenes, customer review, new product/service, before-and-after, special offer, team, tips, event, seasonal, new opening, hiring.
- 20–28 hashtags grouped into sets with names — Your trade & niche (up to 8), Your location (up to 6), Your post topic (up to 5), UK small business (5), Reach & engagement (4), topped up with Extra reach if needed.
- Location combinations built automatically from your town: #LeedsPlumber, #PlumberLeeds, #LeedsBusiness; food trades also get #LeedsEats and #LeedsFoodie. Town names cleaned up properly ("St Albans" → #StAlbansFlorist, "King's Lynn" → #KingsLynnFlorist).
- Every tag validated to Instagram's 30-character limit, duplicates removed, hard cap of 28 tags (two under Instagram's 30-tag maximum, leaving room for one of your own).
- Seeded-random Shuffle for a fresh mix every time; tap any tag to copy just that one; per-set copy; Copy-all block for your caption; Download .txt report.
- A five-rule hashtag tips card with every result: mix tag sizes, go local, rotate your sets, check before you commit, match the tag to the post.
What was removed vs the Altus hosted version
This is the stripped open-source copy: the email-gate form, lead storage (no database table) and all email sending were removed. The full result is shown on screen and copied or downloaded from the page instead. The version hosted on altuswebsolutions.com may offer email delivery; this open-source version does not.
Testing
php -lclean;node --checkclean on both JavaScript files.- The generation logic passed a 329-test Node harness (all 24 trades generate clean 20–28-tag sets, uniqueness, # format, 30-character cap, city validation, topic inclusion, seeded determinism, report text, no support@ anywhere).
- Fresh WordPress 7.1.4 test site (SQLite-backed, PHP 8.3.6): Plugin Check FULL v2.2.0 — 0 errors / 0 warnings on the first run.
- Smoke test on the fresh site: shortcode renders (trade, town and topic fields, Generate button, all assets enqueued), no email form; a live Plumber / Leeds / customer-review generation returned 28 hashtags in 5 groups; database still only the 12 standard WordPress tables after activation (no lead table).
Install
Download altus-hashtag-generator-v1.0.0.zip below → WordPress → Plugins → Add New → Upload Plugin → Install Now → Activate → add [altus_hashtag_generator] to any page.
Disclaimer
Free, "as is", WITHOUT warranty — see the README. Hashtag suggestions are built from popular patterns for UK small businesses — results vary by trade, area and how crowded each tag is, and Instagram's rules may change; check tags on Instagram before relying on them. Always back up your site before installing any plugin and test on staging where possible.
Licence: GPLv2 or later.