{"id":29105105,"url":"https://github.com/chubes4/trivia-block","last_synced_at":"2025-06-29T01:07:02.470Z","repository":{"id":300446896,"uuid":"1006198473","full_name":"chubes4/trivia-block","owner":"chubes4","description":"A modern WordPress Gutenberg block for creating interactive trivia questions with real-time scoring and customizable result messages","archived":false,"fork":false,"pushed_at":"2025-06-21T18:03:26.000Z","size":211,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-21T19:19:19.771Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://chubes.net/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chubes4.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-21T17:59:10.000Z","updated_at":"2025-06-21T18:03:29.000Z","dependencies_parsed_at":"2025-06-21T19:20:14.886Z","dependency_job_id":"2bba7bcf-d67f-4b71-b5be-78d65a9477da","html_url":"https://github.com/chubes4/trivia-block","commit_stats":null,"previous_names":["chubes4/trivia-block"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/chubes4/trivia-block","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubes4%2Ftrivia-block","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubes4%2Ftrivia-block/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubes4%2Ftrivia-block/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubes4%2Ftrivia-block/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chubes4","download_url":"https://codeload.github.com/chubes4/trivia-block/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubes4%2Ftrivia-block/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262518480,"owners_count":23323338,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-29T01:06:57.858Z","updated_at":"2025-06-29T01:07:02.457Z","avatar_url":"https://github.com/chubes4.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Trivia Block - WordPress Plugin\n\n[![WordPress](https://img.shields.io/badge/WordPress-5.9%2B-blue.svg)](https://wordpress.org/)\n[![PHP](https://img.shields.io/badge/PHP-7.4%2B-purple.svg)](https://php.net/)\n[![License](https://img.shields.io/badge/License-GPL%20v2%2B-green.svg)](https://www.gnu.org/licenses/gpl-2.0.html)\n\nA modern Gutenberg block for creating interactive trivia questions with real-time scoring and customizable result messages.\n\n![Trivia Block Demo](https://chubes.net/trivia-block/demo.gif)\n\n## ✨ Features\n\n- **🎯 Interactive Questions** - Multiple choice with immediate feedback\n- **📊 Real-time Scoring** - Tracks progress across all questions on a page\n- **🎨 Custom Results** - Personalized messages for different score ranges\n- **📱 Mobile Responsive** - Works perfectly on all devices\n- **♿ Accessibility First** - Full keyboard navigation and screen reader support\n- **🎭 Themeable** - CSS custom properties for easy integration\n- **⚡ Performance Optimized** - Conditional asset loading and modern build process\n\n## 🚀 Quick Start\n\n### Installation\n\n1. **Download** the latest release from the [releases page](https://github.com/chubes/trivia-block/releases)\n2. **Upload** the plugin to your WordPress site via `Plugins \u003e Add New \u003e Upload`\n3. **Activate** the plugin\n4. **Add** \"Trivia Question\" blocks in the Gutenberg editor\n\n### Development Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/chubes/trivia-block.git\ncd trivia-block\n\n# Install dependencies\nnpm install\n\n# Start development server\nnpm run start\n\n# Build for production\nnpm run build\n\n# Create distribution package\nnpm run dist\n```\n\n## 📋 Usage Examples\n\n### Basic Trivia Question\n\n```javascript\n// Add a trivia block and configure:\nQuestion: \"What year was WordPress first released?\"\nOptions: [\"2001\", \"2003\", \"2005\", \"2007\"]\nCorrect: \"2003\"\n```\n\n### Custom Result Messages\n\nPerfect for themed quizzes:\n\n**🎸 Grateful Dead Trivia**\n- 90%+: \"☠️⚡ True Deadhead - You Know Your Way Around!\"\n- 70%+: \"🌹 Dancing Bear - Well Versed in the Scene\"\n- 50%+: \"🎸 Getting on the Bus - Nice Knowledge!\"\n- \u003c50%: \"🌻 New to the Lot - Keep Exploring!\"\n\n**🏛️ History Quiz**\n- 90%+: \"🏆 Time Traveler - History Scholar!\"\n- 70%+: \"📚 History Buff - Well Read!\"\n- 50%+: \"🤔 Getting There - Keep Learning!\"\n- \u003c50%: \"📖 Just Starting - Lots to Discover!\"\n\n## 🎨 Theming \u0026 Customization\n\nThe plugin uses CSS custom properties for easy theming:\n\n```css\n:root {\n    /* Override these to match your theme */\n    --trivia-card-bg: var(--card-background, #f8fafc);\n    --trivia-border: var(--border-color, #ddd);\n    --trivia-text: var(--text-color, #000);\n    --trivia-accent: var(--accent, #53940b);\n    --trivia-button-bg: var(--button-bg, #0b5394);\n    --trivia-shadow: var(--card-shadow, 0 2px 6px rgba(0,0,0,0.08));\n}\n```\n\n### Dark Mode Support\n\nAutomatically adapts to `prefers-color-scheme: dark`:\n\n```css\n@media (prefers-color-scheme: dark) {\n    :root {\n        --trivia-card-bg: var(--card-background, #2a2a2a);\n        --trivia-text: var(--text-color, #e5e5e5);\n        /* ... more dark mode variables */\n    }\n}\n```\n\n## 🏗️ Architecture\n\n### File Structure\n\n```\ntrivia-block/\n├── src/trivia-block/          # React components\n│   ├── index.js               # Block registration\n│   ├── edit.js                # Editor component\n│   ├── save.js                # Save component\n│   └── block.json             # Block configuration\n├── assets/\n│   ├── css/                   # Stylesheets\n│   └── js/                    # Frontend JavaScript\n├── includes/\n│   └── class-trivia-block-plugin.php  # Main plugin class\n├── build/                     # Compiled assets\n├── dist/                      # Distribution package\n└── trivia-block.php           # Main plugin file\n```\n\n### Technical Stack\n\n- **Frontend**: React with @wordpress/scripts\n- **Backend**: PHP with WordPress standards\n- **Build**: Webpack via @wordpress/scripts\n- **Styling**: CSS with custom properties\n- **API**: WordPress REST API for analytics\n\n## 🧪 Development\n\n### NPM Scripts\n\n```bash\nnpm run start      # Development server with hot reload\nnpm run build      # Production build\nnpm run dist       # Create distribution package\nnpm run lint:js    # Lint JavaScript\nnpm run lint:css   # Lint CSS\nnpm run format     # Format code\n```\n\n### WordPress Standards\n\nThis plugin follows WordPress coding standards:\n\n- PHP: [WordPress PHP Coding Standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/)\n- JavaScript: [WordPress JavaScript Coding Standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/javascript/)\n- CSS: [WordPress CSS Coding Standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/css/)\n\n### Testing\n\n```bash\n# Unit tests\nnpm run test:unit\n\n# E2E tests (when available)\nnpm run test:e2e\n\n# PHP tests (via WordPress test suite)\nphpunit\n```\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Commit your changes: `git commit -m 'Add amazing feature'`\n4. Push to the branch: `git push origin feature/amazing-feature`\n5. Open a Pull Request\n\n### Development Guidelines\n\n- Follow WordPress coding standards\n- Write meaningful commit messages\n- Add tests for new features\n- Update documentation\n- Ensure responsive design\n- Maintain accessibility standards\n\n## 📄 License\n\nThis project is licensed under the GPL v2 or later - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Credits\n\n- **Developer**: [Chris Huber](https://chubes.net)\n- **Built with**: WordPress, React, and ❤️\n- **Inspired by**: The need for engaging, interactive content\n\n## 🐛 Bug Reports \u0026 Feature Requests\n\nFound a bug or have an idea? [Open an issue](https://github.com/chubes/trivia-block/issues)!\n\n## 🚀 Roadmap\n\n- [ ] Question import/export functionality\n- [ ] Timer-based questions\n- [ ] Multiple correct answers support\n- [ ] Question randomization\n- [ ] Analytics dashboard\n- [ ] Block patterns for common quiz types\n\n---\n\n**Trivia Block** - Making WordPress content more interactive, one question at a time! 🎯 ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchubes4%2Ftrivia-block","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchubes4%2Ftrivia-block","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchubes4%2Ftrivia-block/lists"}