Skip to content

SmartTourismChain is a free and open-source WordPress plugin that enables smart contract-based booking simulations for the tourism sector using Ethereum blockchain technology.

License

Notifications You must be signed in to change notification settings

ELPEEF/smarttourismchain

SmartTourismChain

Secure by design, simple by intention.


β€œπŸŽ― This plugin currently uses Ethereum Sepolia for simulation. Ready for the real thing? Migrate to mainnet with your own contract or talk to our team.”


License Build Contributions DOI

SmartTourismChain helps local tourism actors simulate and prepare for real blockchain-based booking systems, without spending real ETH or risking real assets.

You can:

  • Experience real smart contract interaction using Ethereum Sepolia testnet
  • Customize and extend the plugin for your own business logic
  • Use it for training, demos, thesis, or pilot projects
  • Deploy on mainnet or Layer 2 with minor adjustments πŸ”— Smart Contract Repo: smartourism (Solidity)
    πŸ“˜ Documentation: smartourism.elpeef.com/docs

🧩 Features

  • Ethereum + MetaMask integration
  • On-chain and off-chain transaction modes
  • Shortcode-based booking form
  • Admin panel for contract config
  • AJAX/JS Web3.js integration
  • Compatible with WooCommerce (extensible)

πŸ“¦ Installation

  1. Clone this repository:
    git clone https://github.com/ELPEEF/smarttourismchain.git
  2. Upload the folder to your WordPress installation under wp-content/plugins/.
  3. Activate the plugin via WP Admin β†’ Plugins.
  4. Open SmartTourismChain Settings:
  • Input your contract address
  • Paste the ABI JSON
  • Put them into form token or booking mode or both
  1. Use the shortcode below on any page or post: [smartwisata_booking]
  2. Connect MetaMask in frontend and start testing!

πŸ’¬ Frequently Asked Questions

Is this plugin connected to real blockchain payments?

No. The current version runs on Ethereum Sepolia testnet, allowing you to simulate transactions safely and freely.
You can deploy your own smart contract to mainnet or Layer 2 when you're ready.

Why should I install a testnet plugin?

Because this plugin:

  • Prepares you for real blockchain adoption
  • Enables hands-on experience with Web3 in tourism
  • Can be extended to production use with your own token, contract, and payment flow

Can I use my own smart contract?

Yes. The system is flexible. You can insert your own smart contract address and ABI for full customization.

Is there a PRO version?

Yes, a PRO version with white-label features, API access, and real token integration is available at https://smartourism.elpeef.com


🀝 Contributing

We welcome contributions! To get started:

Read our Contribution Guide on https://github.com/ELPEEF/stc-docs.git

or open an issue on GitHub Issues


🧾 License

This project is licensed under the GNU General Public License v3.0.

Use it, improve it, and share it freely. ❀️

Built with πŸ”— by ELPEEF Dev Team


πŸ™Œ Support

You can support SmartTourismChain here to help us keep building awesome tools.


πŸ› οΈ SmartTourismChain System Roadmap

Adapted from modern website development flow, this roadmap documents the key stages in the design, implementation, and deployment of the SmartTourismChain system β€” a blockchain-integrated reservation plugin for the tourism sector.


1. 🧭 Discovery

  • Researching local tourism and UMKM ecosystem
  • Identifying OTA inefficiencies and trust gaps
  • Literature review on Blockchain, Smart Contracts, and CMS
  • Platform selection: Ethereum (Sepolia) + WordPress
  • Initial DSRM problem formulation and scope

πŸ“Œ Output: Problem definition, personas, use case draft


2. ✏️ Prototyping

  • Creating system flow wireframes (on-chain/off-chain)
  • Designing reservation process and whitelist mechanism
  • Initial smart contract draft using Remix IDE
  • Planning user journey and admin experience

πŸ“Œ Output: UX mockups, initial smart contract, interaction flow


3. 🧱 Architecture

  • Defining plugin folder structure
  • Integrating contract ABI and address into frontend/backend
  • Splitting contracts: SmartTourismToken.sol and SmartReservation.sol
  • Planning IoT integration and data pipelines

πŸ“Œ Output: Modular architecture, data flow diagrams, API maps


4. 🎨 Design

  • Designing the UI for reservation and admin panels
  • Creating landing page and token logo
  • Branding "SmartTourismChain" and "RANTAI"
  • Data-informed design decisions based on insights from user behavior, keyword trends, and tourism service gaps

πŸ“Š Source data collected via:

  • Web scraping from local OTA platforms
  • Crawling UMKM and hotel directories
  • Result --> Exploratory Data Analysis (EDA) at: mrbrightsides/dashboard-EDA

πŸ“Œ Output: UI kit, page templates, data-driven feature prioritization, visualized data


5. πŸ“ Content

  • Writing technical documentation in stc-docs
  • Educational narrative for RANTAI landing page
  • Creating Blockchain Enterprise class material
  • GitHub Classroom starter templates

πŸ“Œ Output: Docs site, content modules, course-ready repos


6. πŸ§‘β€πŸ’» Development

  • Building the WordPress plugin with Web3.js and AJAX
  • Implementing on-chain & off-chain reservation logic
  • Logging transactions (txHash, timestamp, etc.)
  • Verifying booking via QR and wallet address

πŸ“Œ Output: Plugin v1.0 (SmartTourismChain), simulation portal


7. πŸ§ͺ Testing

  • Running test transactions on Sepolia Testnet
  • Gas fee analysis and performance benchmarking
  • Security and logic validation
  • Feedback from supervisor and pilot users

πŸ“Œ Output: Evaluation report, bug fixes, ready-to-deploy code


8. πŸš€ Deployment

  • Publishing plugin to WordPress repository
  • Hosting documentation via GitHub Pages
  • Launching https://smartourism.elpeef.com
  • Submitting papers to IMED and IRICT end of 2025

πŸ“Œ Output: Public release, academic publications, open access tools


9. πŸ”§ Maintenance

  • Updating plugin based on user feedback
  • Adding advanced features (NFT tickets, DAO voting, API hooks)
  • Field testing with real UMKM and tourism offices
  • Exploring multi-chain and Layer-2 scalability

πŸ“Œ Output: Plugin v1.x, updated roadmap, community engagement

STC Architecture from scraped dataset to on-chain transactions work flow STC


This adapted roadmap is aligned with Design Science Research Methodology (DSRM), ensuring that every development stage contributes to a rigorous, problem-driven, and impact-oriented innovation process.

About

SmartTourismChain is a free and open-source WordPress plugin that enables smart contract-based booking simulations for the tourism sector using Ethereum blockchain technology.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages