ICO / Presale Module
Launch professional token-sale landing pages with countdown timers, tokenomics charts and three banner styles — fed by four ready-made sample projects
What the ICO Module Is
The ICO / Presale module turns a single WordPress post into a polished token-sale landing page. Each "ICO page" is a custom post (post type ico-page) with hero, info boxes, token details, benefits, roadmap, team, tokenomics and three banner sections. The buy button hands off to the shared Checkout Module, where users pay with PayPal, Stripe, crypto balance or Web3 / MetaMask.
📋 Quick facts
- Default URL pattern:
/ico/<your-slug>/(configurable) - Four sample projects shipped in the box (Space, AI, Gaming, Social)
- Three banner styles: VIP, Hologram, Wave
- Buy flow: shared with the rest of the plugin via Checkout
Where to Find It
Open WP Crypto → ICO Projects. The screen is the standard WordPress post list filtered to the ico-page post type. From there you can Add New to start from scratch, load one of the four samples below, or edit an existing campaign.
Sample Projects
The Add-New screen offers four one-click sample projects. Picking one pre-fills every section so you can start from a polished page and customise rather than from a blank slate.
| Sample key | Theme |
|---|---|
space_token | Space / cosmos branding |
ai_token | AI / machine learning branding |
gaming_token | Gaming / esports branding |
social_token | Social / community branding |
All four samples are real WordPress data — they are not just visual mockups. After loading a sample you can edit every field individually.
Page Sections
An ICO page is built from the following sections. Each section is a tab / accordion in the meta box.
| Section | What it controls |
|---|---|
| Hero | Top banner: project name, tagline, hero image, countdown timer, primary CTA button |
| Info Boxes | The "at-a-glance" stats grid (raised so far, supply, hard cap, soft cap, etc.) |
| Token Details | Token name, ticker, contract address, base price, presale price, bonus structure |
| Benefits | Why-buy bullet list |
| Roadmap | Timeline of upcoming milestones |
| Team | Founders / advisors with photos and links |
| Tokenomics | Pie / bar chart of allocations (rendered with Chart.js) |
| VIP Banner | Mid-page banner in the VIP style (title, button text, link) |
| Hologram Banner | Mid-page banner in the Hologram style (title, button text, link) |
| Wave Banner | Mid-page banner in the Wave style (title, button text, link) |
Banner Styles
The module ships with three banner styles you can mix into the page:
- VIP banner — premium gradient header with gold accents
- Hologram banner — animated iridescent background
- Wave banner — sweeping wave-based hero
Each banner takes a title, a button label and a link target. Leave any banner's title empty to hide it on the public page.
Buy Flow
- Visitor clicks the buy / contribute CTA on the ICO page.
- The plugin creates a pending order with a unique confirmation code and sends the user to the checkout page.
- Checkout charges the user via the chosen gateway (see Checkout Module).
- On payment success the order is marked completed, the bought tokens are credited to the user's internal balance, and the success page renders the receipt.
If a payment fails the order stays pending — the user can retry; there is no automatic "Cancelled" or "Failed" state.
URL Structure
Public ICO pages live under /ico/<your-slug>/ by default. A campaign with WordPress slug my-token lives at /ico/my-token/. You can change the /ico/ prefix from the post-type settings if you prefer a different URL.
Operator Notes
⚠️ Things to know
- Tokenomics charts use Chart.js. Numbers must sum to 100% for the pie chart to look right.
- Countdown timers are visual only. They do not stop the buy button automatically — combine with a manual "Sale closed" toggle if you need a hard cutoff.
- Tokens are credited to the user's internal balance. The module does not deploy or transfer an on-chain token; if you need on-chain delivery, wire up your own contract call after the order is marked
COMPLETED. - One ICO page per campaign. Running two simultaneous sales? Make two ICO pages and link them from a hub page.
Troubleshooting
The page renders without any data
You created the post but did not load a sample or fill the meta box. Either pick a sample on the Add-New screen or fill the sections manually before previewing.
Buy button does not redirect to checkout
Confirm the checkout page URL is set in General Settings → Platform URLs. The ICO module redirects to that URL with the confirmation code appended.
Tokenomics chart is missing
You disabled the Tokenomics section, or none of the slices has a percentage. Open the section and enter values that sum to 100.
A banner appears that I do not want
Clear that banner's title — empty titles hide the banner on the public page.