Revolutionary AI-Powered Cosmic Consciousness & Tarot Experience
Complete 78-card tarot deck with 3D animations, multiple spread options, and cosmic-themed design for immersive readings.
Unique galactic interpretations alongside traditional meanings, channeling wisdom from 19 star race civilizations.
Immersive cosmic experience with custom slug, section navigation, and responsive design for all devices.
Seamless integration with custom shortcodes, admin settings, and optimized performance for WordPress sites.
/cosmic-oracle[cosmic_oracle]
galactic-tarot/
├── cosmic-oracle.php # Main plugin file
├── readme.txt # WordPress plugin repository info
├── SETUP.md # Setup instructions
├── test.html # Testing file
├── assets/
│ ├── cards/ # 78 tarot card images (PNG format)
│ │ ├── 00_The_Fool.png
│ │ ├── 01_The_Magician.png
│ │ └── ... (76 more cards)
│ ├── css/
│ │ ├── cosmic-oracle-style.css # Main cosmic theme styles
│ │ ├── style.css # Base plugin styles
│ │ ├── bootstrap.min.css # Bootstrap framework
│ │ ├── fontawesome.min.css # Font Awesome icons
│ │ ├── brands.min.css # Font Awesome brands
│ │ └── solid.min.css # Font Awesome solid icons
│ ├── data/
│ │ └── meanings.json # Complete card meanings database
│ ├── fonts/ # Custom fonts
│ ├── js/
│ │ └── cosmic-oracle-app.js # Main JavaScript functionality
│ └── webfonts/ # Font Awesome webfonts
├── docs/
│ ├── cosmic-oracle-anchor-links.txt # Marketing anchor links
│ └── plugin-documentation.md # This documentation file
├── includes/
│ ├── class-cosmic-oracle.php # Main plugin class
│ └── class-galactic-tarot.php # Legacy class (maintained for compatibility)
├── languages/ # Translation files (empty - ready for i18n)
└── templates/
├── cosmic-oracle-page.php # Complete landing page template
├── shortcode-cosmic-oracle.php # Shortcode template
└── shortcode-tarot.php # Legacy shortcode template
Installation
1. Upload the folder to /wp-content/plugins/
2. Activate the plugin through the WordPress admin 'Plugins' menu
3. The plugin will automatically create rewrite rules for the page
4. Visit yoursite.com/cosmic-oracle to see the complete experience
Usage
Shortcode Usage
Insert the cosmic oracle anywhere in your content:
`
[cosmic_oracle]
Landing Page
The plugin automatically creates a complete landing page accessible at:
https://yoursite.com/cosmic-oracle
Anchor Links
The landing page includes section anchors for direct navigation:
- - Main hero section
- #welcome - Welcome section
- #how-it-works - How it works explanation
- #tarot - Interactive tarot section
- #star-races - Star races information
- #purpose - Celestial purpose section
- #enlightenment - Enlightenment path
- #portal - Cosmic portal section
Technical Specifications
CSS Framework
The plugin uses a custom cosmic theme with CSS variables:
`css
:root {
--co-bg: #01021B; / Deep space background /
--co-gold: #E8CC80; / Cosmic gold accents /
--co-teal: #87D6FF; / Stellar teal highlights /
--co-ink: #D4C6A8; / Cosmic text color /
--co-deep: #03062F; / Deep cosmic blue /
}
`
JavaScript Architecture
- ES6+ JavaScript with async/await patterns
- Class-based structure with main class
- Fetch API for loading card meanings
- CSS Grid and Flexbox for responsive layouts
- Custom 3D CSS animations
Card Data Structure
Each card includes:
`json
{
"id": 1,
"name": "The Fool",
"image": "00_The_Fool.png",
"meanings": {
"upright": "Traditional upright meaning",
"reversed": "Traditional reversed meaning",
"galactic_upright": "Galactic consciousness upright",
"galactic_reversed": "Galactic consciousness reversed"
}
}
`
Configuration
Plugin Settings
Currently, the plugin works out-of-the-box without additional configuration. Future versions may include:
- Custom card sets
- Theme color customization
- Reading history
- User accounts integration
Cache Management
For development, the plugin includes cache-busting features:
- Timestamp-based asset versioning
- No-cache headers (removable for production)
Star Races Integration
The plugin features 19 galactic civilizations:
1. Arcturians - Wisdom and healing
2. Pleiadians - Love and emotional healing
3. Sirians - Sacred knowledge and ascension
4. Orions - Duality and integration
5. Zeta Reticuli (Greys) - Technology and consciousness
6. Vega Starborn - Creative expression and harmony
7. Antarians - Warrior healers and transformation
8. Alpha Centaurians - Crystal energy and manifestation
9. Hyadeans - Water wisdom and flow
10. Lyrans - Ancient wisdom and creativity
11. Andromedans - Freedom and balance
12. Cassiopeians - Scientific advancement
13. Draconians - Power and leadership
14. Tau Cetians - Environmental harmony
15. Procyonians - Logic and analysis
16. Mintakans - Service and healing
17. Polarians - Navigation and guidance
18. Agarthans - Inner Earth crystalline light
19. Galactic Federation - Unified cosmic consciousness
Customization
Themes
The cosmic theme can be customized by modifying CSS variables in :
`css
:root {
--co-bg: your-background-color;
--co-gold: your-accent-color;
--co-teal: your-highlight-color;
--co-ink: your-text-color;
}
`
Card Meanings
Card meanings can be updated by modifying . Each card entry supports:
- upright: Traditional upright meaning
- reversed: Traditional reversed meaning
- galactic_upright: Cosmic perspective upright
- galactic_reversed: Cosmic perspective reversed
Spreads
Additional spread types can be added by extending the JavaScript in cosmic-oracle-app.js:
`javascript
// Add new spread option
const spreads = {
'custom': {
name: 'Custom Spread',
positions: ['Position 1', 'Position 2', 'Position 3']
}
};
`
Troubleshooting
Common Issues
1. Cards not displaying
- Check that card images exist in
- Verify file permissions are correct
- Clear browser cache
2. Shortcode not working
- Ensure plugin is activated
- Check for JavaScript errors in console
- Verify is loading
3. Landing page 404 error
- Go to Settings > Permalinks and click "Save"
- Check if rewrite rules are flushed
- Verify .htaccess is writable
4. Styling issues
- Clear browser cache
- Check for CSS conflicts with theme
- Verify cosmic-oracle-style.css is loading
Debug Mode
Enable WordPress debug mode by adding to wp-config.php:
`php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
`
Performance Optimization
Image Optimization
- Card images are optimized PNG files
- Lazy loading implemented for card images
- Fallback handling for missing images
CSS/JS Optimization
- Minified versions available for production
- CSS variables reduce file size
- Conditional loading based on page context
Security Considerations
- All user inputs are sanitized
- Nonces used for form submissions
- File access restrictions in place
- No direct PHP file access allowed
Browser Compatibility
- Chrome 70+
- Firefox 65+
- Safari 12+
- Edge 79+
- Mobile browsers supported
Future Enhancements
Planned Features
1. User Accounts
- Reading history
- Favorite cards
- Personal notes
2. Advanced Spreads
- Celtic Cross
- Astrological spreads
- Custom spread builder
3. Audio Integration
- Guided meditations
- Cosmic soundscapes
- Card reading narration
4. Multi-language Support
- Translation ready
- RTL language support
- Cultural adaptations
5. API Integration
- RESTful API endpoints
- Mobile app connectivity
- Third-party integrations
Support
For support and updates:
- Website: https://galacticfederation.in
- Documentation: Check