Skip to content

magamawi/TiD-Forms

Repository files navigation

TiD Forms - WordPress Forms Plugin

A beautiful, modern WordPress forms plugin designed to replace WPForms with stunning UI/UX and powerful functionality. Built specifically for The Innovative Dinosaur website.

πŸš€ Quick Start with GitHub Codespaces

Open in GitHub Codespaces

  1. Click the "Open in GitHub Codespaces" button above
  2. Wait for the environment to load
  3. Run the demo: cd wordpress-demo && source venv/bin/activate && python src/main.py
  4. Open the preview URL to see the WordPress admin interface

πŸ“ Project Structure

TiD-Forms/
β”œβ”€β”€ wordpress-plugin/          # Complete WordPress plugin
β”‚   β”œβ”€β”€ innovative-forms.php   # Main plugin file
β”‚   β”œβ”€β”€ includes/             # Core plugin classes
β”‚   β”œβ”€β”€ admin/               # Admin interface
β”‚   β”œβ”€β”€ public/              # Frontend assets
β”‚   └── README.md            # Plugin documentation
β”œβ”€β”€ marketing-website/        # React marketing site
β”‚   β”œβ”€β”€ src/                 # React source code
β”‚   β”œβ”€β”€ dist/                # Built website
β”‚   └── package.json         # Dependencies
β”œβ”€β”€ wordpress-demo/           # WordPress admin demo
β”‚   β”œβ”€β”€ src/                 # Flask application
β”‚   β”œβ”€β”€ venv/                # Python virtual environment
β”‚   └── requirements.txt     # Python dependencies
β”œβ”€β”€ docs/                    # Documentation
β”‚   β”œβ”€β”€ mvp_requirements.md  # MVP specifications
β”‚   β”œβ”€β”€ technical_architecture_design.md
β”‚   └── website_analysis.md
└── .devcontainer/           # Codespaces configuration

🎯 Features

✨ WordPress Plugin

  • 5 Stunning Themes: Modern, Professional, Elegant, Creative, Minimal
  • Beautiful Forms: Newsletter, Contributors, Contact forms
  • Admin Interface: Complete WordPress-style admin panel
  • Entry Management: View, filter, export form submissions
  • Security: Spam protection, GDPR compliance, input sanitization
  • Shortcode System: [innovative_form id="1"]

🎨 Marketing Website

  • Interactive Demos: Live form previews with theme switching
  • Professional Design: Modern gradients and animations
  • Mobile Responsive: Perfect on all devices
  • Download Portal: Plugin distribution

πŸ› οΈ WordPress Demo

  • Live Admin Interface: Test the plugin in action
  • Form Management: Create, edit, preview forms
  • Entry Dashboard: View submissions and export CSV
  • Settings Panel: Configure plugin options

πŸš€ Getting Started

Option 1: GitHub Codespaces (Recommended)

  1. Click "Open in GitHub Codespaces" above
  2. Everything is pre-configured and ready to run

Option 2: Local Development

Prerequisites

  • Node.js 18+
  • Python 3.11+
  • Git

Setup

# Clone the repository
git clone https://github.com/magamawi/TiD-Forms.git
cd TiD-Forms

# Setup WordPress Demo
cd wordpress-demo
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
python src/main.py

# Setup Marketing Website (in new terminal)
cd marketing-website
npm install
npm run dev

# WordPress Plugin is ready to install
# Upload wordpress-plugin/ folder to your WordPress site

🌐 Live Demos

πŸ“– Documentation

🎨 Form Themes

Modern Theme

  • Purple-blue gradients
  • Glass morphism effects
  • Smooth animations

Professional Theme

  • Corporate blue styling
  • Clean, business-focused design
  • Professional typography

Elegant Theme

  • Purple gradients
  • Sophisticated styling
  • Refined aesthetics

Creative Theme

  • Vibrant colors
  • Artistic design elements
  • Dynamic animations

Minimal Theme

  • Clean, simple design
  • Focus on content
  • Subtle interactions

πŸ”§ WordPress Plugin Installation

  1. Download the plugin from the marketing website
  2. Upload wordpress-plugin/ to your WordPress /wp-content/plugins/ directory
  3. Activate the plugin in WordPress admin
  4. Go to "Innovative Forms" in the admin menu
  5. Create your first form and use the shortcode

πŸ›‘οΈ Security Features

  • Spam Protection: Honeypot fields and rate limiting
  • GDPR Compliance: Consent management and privacy controls
  • Input Sanitization: XSS and SQL injection prevention
  • WordPress Security: Nonces and capability checks

πŸ“Š Entry Management

  • Dashboard View: All form submissions in one place
  • Filter & Search: Find specific entries quickly
  • CSV Export: Excel-compatible data export
  • Entry Details: Complete submission information

🎯 MVP Features

This is the Minimum Viable Product (MVP) version focusing on:

  • βœ… Core form functionality
  • βœ… Beautiful themes
  • βœ… WordPress integration
  • βœ… Entry management
  • βœ… CSV export
  • βœ… Basic security

Future enhancements may include:

  • Email notifications
  • Payment processing
  • Advanced conditional logic
  • Third-party integrations
  • Drag-and-drop form builder

🀝 Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ¦• About The Innovative Dinosaur

This plugin was specifically designed for The Innovative Dinosaur website to replace WPForms with a more beautiful and customizable solution.

πŸ†˜ Support

  • Issues: GitHub Issues
  • Documentation: docs/ folder
  • Live Demo: Test features at the demo links above

πŸŽ‰ Acknowledgments

  • Built with modern web technologies
  • Designed for WordPress best practices
  • Focused on user experience and security
  • Created with ❀️ for The Innovative Dinosaur

Ready to transform your WordPress forms? Get started with TiD Forms today! πŸš€

About

Beautiful WordPress forms plugin to replace WPForms - Built for The Innovative Dinosaur

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published