9 Commits

10 changed files with 1382 additions and 44 deletions

111
DEVELOPMENT.md Normal file
View File

@ -0,0 +1,111 @@
# WP Allstars Plugin Development Workflow
This document outlines the development workflow for the WP Allstars Plugin to ensure stable and reliable feature implementation.
## Development Principles
1. **Stability First**: The primary goal is maintaining a stable plugin that works reliably
2. **Incremental Changes**: Implement changes in small, manageable increments
3. **Complete Testing**: Every change must be thoroughly tested before integration
4. **Documentation**: All features and changes must be well-documented
## Branch Structure
- `main` - Production-ready code, always stable
- `v0.2.3-stable` - Our current stable development branch
- `feature/v0.2.3-stable/{feature-name}` - Feature branches for new development
## Development Workflow
### 1. Feature Planning
1. Identify a feature from the ROADMAP.md file to implement
2. Review any existing implementation in unstable versions
3. Document the implementation plan in ROADMAP.md
4. Create a new feature branch from the stable base
```bash
git checkout v0.2.3-stable
git checkout -b feature/v0.2.3-stable/sync-guard
```
### 2. Feature Implementation
1. Start with the smallest possible functional change
2. Commit frequently with descriptive commit messages including stability classification
3. Example commit message format:
```
[EXPERIMENTAL] Add basic sync guard detection functionality
- Adds file existence check for .syncing flag
- Implements conditional loading based on flag
- Does not yet handle admin notices
```
4. Reference the ROADMAP.md and TESTING.md documents while implementing
### 3. Testing
1. Complete all relevant tests from TESTING.md
2. Add feature-specific tests if needed
3. Test in a clean WordPress environment
4. Test with WP_DEBUG enabled
5. Document any issues found and fix them
### 4. Code Review
1. Self-review code for:
- PHP best practices
- WordPress coding standards
- Security considerations
- Performance implications
- Error handling
2. Consider peer review if possible
### 5. Integration
1. Create a pull request to merge into the stable branch
2. Summarize changes, testing performed, and any caveats
3. Once approved, merge using `--no-ff` to preserve feature history
```bash
git checkout v0.2.3-stable
git merge --no-ff feature/v0.2.3-stable/sync-guard
```
4. Tag new version if appropriate:
```bash
git tag v0.2.3.1-stable
git push origin v0.2.3.1-stable
```
5. Update STABILITY.md with the new version information
### 6. Post-Integration
1. Deploy to test environment and confirm functionality
2. Update ROADMAP.md to reflect the implemented feature
3. Clean up feature branch if no longer needed
## Handling Unstable Code References
When examining code from unstable versions:
1. **Never copy-paste directly** - Understand the approach and reimplement
2. **Isolate problematic code** - Identify why it might have failed
3. **Take the best ideas** - Implement the concept, not the exact implementation
4. **Document the reference** - Note which version inspired each implementation
## Versioning Scheme
- `vX.Y.Z` - Major.Minor.Patch
- `vX.Y.Z-stable` - Stable development branches
- `vX.Y.Z.N-stable` - Minor updates to stable branches
## Continuous Improvement
- Regularly review and update these development procedures
- Document lessons learned
- Improve testing procedures based on discoveries

View File

@ -1,6 +1,7 @@
# WP Allstars # WP Allstars
A WordPress plugin that enhances your WordPress experience with curated plugins, themes, and optimization tools. A WordPress plugin that enhances your WordPress experience with curated plugins, themes, and optimization tools.
Current version: v0.2.3.3 (stable)
## Description ## Description
@ -8,6 +9,8 @@ WP Allstars is a powerful WordPress plugin designed to help site owners and deve
## Features ## Features
- **Modern Admin UI**: Enhanced admin interface with responsive design and interactive components.
- **Admin Color Schemes**: Switch between default and modern admin color schemes.
- **Curated Plugin Recommendations**: Browse and install recommended free plugins organized by category. - **Curated Plugin Recommendations**: Browse and install recommended free plugins organized by category.
- **Pro Plugin Showcase**: Discover premium plugins with direct links to purchase. - **Pro Plugin Showcase**: Discover premium plugins with direct links to purchase.
- **Theme Integration**: Easily install and activate the Kadence theme. - **Theme Integration**: Easily install and activate the Kadence theme.
@ -28,6 +31,8 @@ After activation, you'll find the WP Allstars menu in your WordPress admin sideb
### General ### General
Basic settings for the plugin, including: Basic settings for the plugin, including:
- Admin UI Enhancements
- Admin Color Schemes
- Auto Upload Images - Auto Upload Images
- Image Optimization - Image Optimization
- Cache Management - Cache Management
@ -77,6 +82,15 @@ Discover premium plugins with direct links to purchase.
Easily install and activate the Kadence theme. Easily install and activate the Kadence theme.
## UI Components
The plugin includes several enhanced UI components:
- **Cards**: Flexible containers for displaying content with optional headers and footers
- **Accordions**: Collapsible content panels for presenting information in a limited space
- **Notifications**: Stylish notifications for providing user feedback
- **Enhanced Form Elements**: Improved styling for inputs, buttons, and toggles
## Development ## Development
### Requirements ### Requirements

139
ROADMAP.md Normal file
View File

@ -0,0 +1,139 @@
# WP Allstars Plugin Development Roadmap
This document outlines features from later versions that we plan to integrate into our stable development branch. The goal is to incrementally implement these features in a stable manner, without introducing critical errors.
## Feature Backlog
| Feature | Source Version | Priority | Complexity | Risk | Status |
|---------|----------------|----------|------------|------|--------|
| Multisite Category | v0.2.6 | High | Low | Low | ✅ Implemented in v0.2.3-stable |
| Sync Guard | v0.2.6-fix | High | Low | Low | ✅ Implemented in v0.2.3.1-stable |
| More Robust File Loading | v0.2.6-fix | High | Low | Low | ✅ Implemented in v0.2.3-stable |
| Admin Colors Feature | v0.2.4 | High | Low | Low | ✅ Implemented in v0.2.3.2-stable |
| Basic Admin UI Enhancements | v0.2.5 | High | Medium | Medium | ✅ Implemented in v0.2.3.3-stable |
| Advanced Admin UI Components | v0.2.5 | Medium | Medium | Medium | 🔄 To be implemented |
| Access Manager Improvements | v0.2.5 | Medium | Medium | Medium | 🔄 To be implemented |
| Role-Based Access Controls | v0.2.5.1 | High | Medium | Medium | 🔄 To be implemented |
| Improved Plugin Structure | v0.2.5 | Medium | Medium | High | 🔄 To be implemented |
| Performance Optimizations | v0.2.6 | Medium | Medium | Medium | 🔄 To be implemented |
| Enhanced Plugin Filtering | v0.2.6 | Medium | Medium | Low | 🔄 To be implemented |
| Plugin Settings Export/Import | v0.2.6 | Low | High | Medium | 🔄 To be implemented |
| Plugin Dashboard | v0.2.6-fix | Medium | Medium | Medium | 🔄 To be implemented |
| New Category Pages | v0.2.4+ | Medium | Low | Low | 🔄 To be implemented |
## Implementation Strategy
### Multisite Category with Network Plugin Auditor
- **Description**: Add a "Multisite" filter after Advanced and include network-plugin-auditor
- **Why it failed before**: Didn't properly update all required files for the feature
- **Implementation plan**: Add to free-plugins.php and update class-free-plugins-manager.php to display the category correctly
- **Testing criteria**: Verify category appears in UI and plugin can be installed
### Sync Guard
- **Description**: Prevent plugin loading during rsync operations to avoid partial file loading
- **Why it failed before**: Added to wrong location, dependent on missing files
- **Implementation plan**:
1. Create a simpler version of the sync guard
2. Update post-commit hook to handle sync operations better
3. Use file flag to signal when sync is in progress
- **Testing criteria**: Verify plugin doesn't attempt to load during sync operations
### Admin Colors Feature
- **Description**: Allow users to switch between default and modern admin color schemes
- **Why it's valuable**: Provides visual distinction and improves user experience
- **Implementation plan**:
1. Create class-wp-allstars-admin-colors.php
2. Add toggle in settings to switch color schemes
3. Register the feature in the main plugin file
- **Testing criteria**: Verify color scheme changes when toggled
### Basic Admin UI Enhancements
- **Description**: Improve the basic styling of admin interfaces
- **Why it's valuable**: Better user experience and modern look
- **Implementation plan**:
1. Create class-wp-allstars-ui-enhancements.php
2. Implement UI components like cards, accordions, and notifications
3. Add responsive design improvements
- **Testing criteria**: Verify UI components work correctly across different screen sizes
- **Status**: ✅ Implemented in v0.2.3.3-stable
### Advanced Admin UI Components
- **Description**: Add more sophisticated UI elements and interactions
- **Why it's valuable**: Enhanced usability and professional appearance
- **Implementation plan**:
1. Implement enhanced toggles and accordions
2. Add notification styling
3. Improve plugin cards and layouts
- **Testing criteria**: Verify all UI components work correctly across browsers
### Access Manager Improvements
- **Description**: Enhance user role and permission management
- **Why it's valuable**: More granular control over plugin features
- **Implementation plan**:
1. Update class-access-manager.php
2. Add role checkboxes in UI
3. Implement proper access restriction handling
- **Testing criteria**: Verify correct permissions are applied based on user roles
### Role-Based Access Controls
- **Description**: Implement fine-grained access controls for different user roles
- **Why it's valuable**: Allows administrators to restrict access to specific plugin features
- **Implementation plan**:
1. Create role capability mapping system
2. Add permission checks throughout the plugin
3. Create UI for managing role permissions
- **Testing criteria**: Verify users can only access features appropriate to their role
### Improved Plugin Structure
- **Description**: Better organization of code with clearer separation of concerns
- **Why it's valuable**: More maintainable codebase and fewer dependency issues
- **Implementation plan**:
1. Reorganize class loading order
2. Improve dependency management
3. Enhance error handling for API calls
- **Testing criteria**: Verify plugin loads correctly with no dependency errors
### Performance Optimizations
- **Description**: Improve plugin performance and resource usage
- **Why it's valuable**: Better user experience and lower server load
- **Implementation plan**:
1. Optimize asset loading (CSS/JS)
2. Reduce database queries
3. Implement caching for external API requests
- **Testing criteria**: Verify reduced page load times and server resource usage
### Enhanced Plugin Filtering
- **Description**: More advanced filtering options for the plugins section
- **Why it's valuable**: Makes it easier for users to find relevant plugins
- **Implementation plan**:
1. Add category-specific icons and metadata
2. Implement more filtering options
3. Improve search functionality
- **Testing criteria**: Verify filtering works correctly and improves plugin discovery
### Plugin Settings Export/Import
- **Description**: Allow users to backup and restore plugin settings
- **Why it's valuable**: Easier migration between environments and configuration backup
- **Implementation plan**:
1. Create export functionality for settings
2. Implement import/restore capability
3. Add settings profiles for different use cases
- **Testing criteria**: Verify settings can be exported and successfully imported on another site
## Development Order
The suggested implementation order is:
1. ✅ Admin Colors Feature (low complexity, enhances UI)
2. ✅ Basic Admin UI Enhancements (foundation for other UI improvements)
3. Role-Based Access Controls (security-related, high priority)
4. Advanced Admin UI Components (builds on basic UI)
5. Access Manager Improvements (depends on UI components and role controls)
6. Performance Optimizations (improves user experience)
7. Enhanced Plugin Filtering (better usability)
8. Improved Plugin Structure (code quality)
9. Plugin Dashboard improvements (adds functionality)
10. New Category Pages (content enhancement)
11. Plugin Settings Export/Import (advanced functionality)
Each feature should be developed in its own branch and only merged after thorough testing.

41
STABILITY.md Normal file
View File

@ -0,0 +1,41 @@
# WP Allstars Plugin Stability Status
This document tracks the stability status of different versions of the WP Allstars Plugin.
## Stability Classification
- **[STABLE]**: Thoroughly tested, works as expected in production environments
- **[FUNCTIONAL]**: Works but may have minor issues or incomplete features
- **[EXPERIMENTAL]**: Contains new features that are not fully tested
- **[UNSTABLE]**: Known to have critical issues that affect functionality
## Version Status
| Version | Status | Notes |
|---------|--------|-------|
| v0.2.3.3 | **[FUNCTIONAL]** | Stable version with Basic Admin UI Enhancements - adds improved components and responsive design. |
| v0.2.3.2 | **[STABLE]** | Stable version with Admin Colors feature properly implemented. |
| v0.2.3.1 | **[STABLE]** | Stable version with Sync Guard feature implemented. |
| v0.2.3-stable-base | **[STABLE]** | Base stable version with robust file loading. All core functionality works properly. |
| v0.2.4 | **[UNSTABLE]** | Contains critical errors - reference only for feature ideas. |
| v0.2.6 | **[UNSTABLE]** | Contains file structure issues and critical errors - reference only for feature ideas. |
| v0.2.6-fix | **[UNSTABLE]** | Attempted fixes but still has issues - reference only. |
| v0.2.6-revert | **[UNSTABLE]** | Failed attempt to revert to stable version - do not use. |
## Current Development
Current development is based on the v0.2.3-stable-base version with incremental feature additions. We're implementing features from the roadmap while maintaining stability.
## Implemented Features
1. Robust File Loading (v0.2.3-stable-base)
2. Sync Guard (v0.2.3.1)
3. Admin Colors Feature (v0.2.3.2)
4. Basic Admin UI Enhancements (v0.2.3.3)
## Stability Guidelines
1. All new features must be developed in isolated feature branches
2. Comprehensive testing is required before merging
3. Each feature should be implemented as a series of small, atomic commits
4. All commits should include a stability classification in commit messages: [STABLE], [FUNCTIONAL], etc.
5. Full testing checklist must be completed before marking a version as [STABLE]

163
TESTING.md Normal file
View File

@ -0,0 +1,163 @@
# WP Allstars Plugin Testing Guide
This document provides testing checklist for the WP Allstars Plugin to ensure stability and functionality.
## General Testing Guidelines
1. Test each feature in isolation before testing integrated functionality
2. Test on multiple WordPress versions (5.8+)
3. Test with different themes activated
4. Test with and without other plugins activated
5. Test on different screen sizes (desktop, tablet, mobile)
## Feature-Specific Testing
### Multisite Category
- [ ] Verify "Multisite" category appears in plugin list filters
- [ ] Verify plugins in the multisite category appear when the filter is selected
- [ ] Verify network-plugin-auditor appears in multisite category
- [ ] Test installation of network-plugin-auditor via the plugin interface
### Sync Guard
- [ ] Create a .syncing file in the plugin root directory
- [ ] Verify plugin displays "syncing" notice instead of loading
- [ ] Remove .syncing file
- [ ] Verify plugin loads normally after removing .syncing file
### Admin Colors Feature
- [ ] Verify Admin Colors toggle appears in settings
- [ ] Toggle the admin colors option to "Modern"
- [ ] Verify admin UI updates with modern colors
- [ ] Toggle back to "Default"
- [ ] Verify admin UI returns to default colors
- [ ] Test color switching on different pages of the admin
- [ ] Verify setting is saved when toggling
### Basic Admin UI Enhancements
- [ ] Verify basic UI components are properly styled (buttons, forms, etc.)
- [ ] Test responsive behavior on different screen sizes
- [ ] Verify card components display properly with headers and footers
- [ ] Test accordion functionality (expand/collapse)
- [ ] Verify notification components display properly with different types (success, error, warning)
- [ ] Test dismissible notifications
- [ ] Verify that UI components are properly styled across different WordPress admin pages
- [ ] Test keyboard accessibility for interactive components
## Integration Testing
- [ ] Verify all features work together without conflicts
- [ ] Test performance impact with all features enabled
- [ ] Verify plugin loads without errors on plugin activation
- [ ] Test deactivation and reactivation
## Browser Compatibility
Test on the following browsers:
- [ ] Chrome (latest)
- [ ] Firefox (latest)
- [ ] Safari (latest)
- [ ] Edge (latest)
## Performance Testing
- [ ] Measure page load time before and after enabling the plugin
- [ ] Check for any JavaScript errors in browser console
- [ ] Verify CSS is properly cached
- [ ] Ensure assets are properly minified
## Version Upgrade Testing
When testing a new version:
- [ ] Test upgrading from previous version
- [ ] Verify settings are preserved during upgrade
- [ ] Check for any deprecation warnings or errors
## Security Testing
- [ ] Verify all admin pages are properly secured
- [ ] Check for proper escaping of output
- [ ] Verify nonce checks on form submissions
- [ ] Test with user roles other than administrator
## Final Pre-Release Checklist
- [ ] All tests passed on multiple environments
- [ ] Version numbers updated in all files
- [ ] Changelog updated
- [ ] Documentation reflects new features
- [ ] All scripts and styles properly enqueued
## Regression Testing
After implementing new features, perform regression testing on previously implemented features to ensure they still function correctly.
## Pre-Merge Testing Checklist
### Basic Functionality Tests
- [ ] Plugin activates without errors
- [ ] Plugin deactivates without errors
- [ ] Admin menu appears correctly
- [ ] All submenu items load without errors
- [ ] Settings can be saved without errors
- [ ] Plugin works with WordPress debug mode enabled
### Feature-Specific Tests
Each new feature should have its own testing checklist added here.
#### Multisite Category Feature
- [ ] "Multisite" category appears in the correct location in the UI
- [ ] Network Plugin Auditor appears in the Multisite category
- [ ] Category filter works when clicked
- [ ] Plugin can be installed from the category
#### Sync Guard Feature
- [ ] Plugin doesn't load when .syncing file is present
- [ ] .syncing file is created during sync operations
- [ ] .syncing file is removed after sync completes
- [ ] User is notified when plugin is in sync mode
### Compatibility Tests
- [ ] Plugin works with latest WordPress version
- [ ] Plugin works with PHP 7.4+
- [ ] Plugin works with common themes (Twenty Twenty-Three, Kadence)
- [ ] Plugin co-exists with other popular plugins without conflicts
### Browser Compatibility
- [ ] UI works correctly in Chrome
- [ ] UI works correctly in Firefox
- [ ] UI works correctly in Safari
- [ ] UI works correctly in Edge
### Mobile Responsiveness
- [ ] Admin interface is usable on mobile devices
- [ ] No layout issues on small screens
## Testing Process
1. Create a clean WordPress installation for testing
2. Install and activate the plugin
3. Enable WordPress debug mode (WP_DEBUG = true)
4. Complete all tests in the checklist
5. Document any issues found
6. Fix issues and retest
7. Only mark as [STABLE] when all tests pass
## Continuous Integration
For future implementation:
- [ ] Automated unit tests
- [ ] Integration tests
- [ ] End-to-end tests
- [ ] Code quality checks

View File

@ -0,0 +1,404 @@
/**
* WP Allstars UI Enhancements
*
* Provides enhanced UI components for the WP Allstars plugin
* Building on the foundation of wp-allstars-admin.css
*/
/*
* Enhanced UI Base Styles
* These styles apply to the entire admin area when the enhanced UI is activated
*/
.wp-allstars-enhanced-ui #wpcontent {
padding-left: 0;
}
.wp-allstars-enhanced-ui .wp-allstars-wrap {
padding: 0 20px 20px;
max-width: 1200px;
margin: 0 auto;
}
/*
* Cards Component
* A flexible container for displaying content with an optional header and footer
*/
.wp-allstars-card {
background: #fff;
border-radius: 8px;
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
margin-bottom: 20px;
transition: box-shadow 0.3s ease, transform 0.2s ease;
overflow: hidden;
border: 1px solid #e5e5e5;
}
.wp-allstars-card:hover {
box-shadow: 0 4px 12px rgba(0, 0, 0, 0.12);
transform: translateY(-2px);
}
.wp-allstars-card-header {
padding: 15px 20px;
border-bottom: 1px solid #f0f0f0;
display: flex;
align-items: center;
background: #fbfbfb;
}
.wp-allstars-card-icon {
margin-right: 12px;
color: #2271b1;
flex-shrink: 0;
}
.wp-allstars-card-title {
font-size: 16px;
font-weight: 600;
color: #1d2327;
flex-grow: 1;
}
.wp-allstars-card-content {
padding: 20px;
}
.wp-allstars-card-footer {
padding: 12px 20px;
border-top: 1px solid #f0f0f0;
background: #fbfbfb;
}
/*
* Accordion Component
* Collapsible content panels for presenting information in a limited space
*/
.wp-allstars-accordion {
background: #fff;
border-radius: 8px;
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
margin-bottom: 15px;
overflow: hidden;
border: 1px solid #e5e5e5;
}
.wp-allstars-accordion-header {
padding: 15px 20px;
cursor: pointer;
display: flex;
justify-content: space-between;
align-items: center;
background: #fbfbfb;
transition: background-color 0.2s ease;
user-select: none;
}
.wp-allstars-accordion-header:hover {
background: #f6f7f7;
}
.wp-allstars-accordion-title {
font-size: 15px;
font-weight: 600;
color: #1d2327;
}
.wp-allstars-accordion-icon {
width: 20px;
height: 20px;
position: relative;
transition: transform 0.3s ease;
}
.wp-allstars-accordion-icon::before,
.wp-allstars-accordion-icon::after {
content: '';
position: absolute;
background-color: #2271b1;
transition: transform 0.3s ease;
}
.wp-allstars-accordion-icon::before {
top: 9px;
left: 0;
width: 20px;
height: 2px;
}
.wp-allstars-accordion-icon::after {
top: 0;
left: 9px;
width: 2px;
height: 20px;
}
.wp-allstars-accordion-header[aria-expanded="true"] .wp-allstars-accordion-icon::after {
transform: rotate(90deg);
}
.wp-allstars-accordion-content {
display: none;
border-top: 1px solid #f0f0f0;
}
.wp-allstars-accordion-inner {
padding: 20px;
}
/*
* Enhanced Button Styles
* Improved button appearance and interactions
*/
.wp-allstars-enhanced-ui .button {
border-radius: 4px;
transition: all 0.2s ease;
border-color: #c3c4c7;
padding: 0 12px;
height: 36px;
line-height: 34px;
box-shadow: none;
}
.wp-allstars-enhanced-ui .button:hover,
.wp-allstars-enhanced-ui .button:focus {
background: #f6f7f7;
border-color: #8c8f94;
box-shadow: 0 1px 2px rgba(0, 0, 0, 0.08);
outline: none;
}
.wp-allstars-enhanced-ui .button-primary {
background: #2271b1;
border-color: #2271b1;
color: #fff;
}
.wp-allstars-enhanced-ui .button-primary:hover,
.wp-allstars-enhanced-ui .button-primary:focus {
background: #135e96;
border-color: #135e96;
color: #fff;
box-shadow: 0 1px 2px rgba(0, 0, 0, 0.2);
}
.wp-allstars-enhanced-ui .button-large {
height: 40px;
line-height: 38px;
padding: 0 16px;
font-size: 14px;
}
.wp-allstars-enhanced-ui .button-small {
height: 28px;
line-height: 26px;
padding: 0 8px;
font-size: 12px;
}
/*
* Enhanced Toggle Styles
*/
.wp-allstars-enhanced-ui .wp-toggle-switch {
width: 46px;
height: 24px;
}
.wp-allstars-enhanced-ui .wp-toggle-slider {
border-radius: 24px;
background-color: #ccc;
transition: all 0.3s cubic-bezier(0.4, 0.0, 0.2, 1);
}
.wp-allstars-enhanced-ui .wp-toggle-slider:before {
height: 18px;
width: 18px;
left: 3px;
bottom: 3px;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.2);
transition: all 0.3s cubic-bezier(0.4, 0.0, 0.2, 1);
}
.wp-allstars-enhanced-ui input:checked + .wp-toggle-slider {
background-color: #2271b1;
}
.wp-allstars-enhanced-ui input:checked + .wp-toggle-slider:before {
transform: translateX(22px);
}
/*
* Notification Component
* Stylish notifications for providing user feedback
*/
.wp-allstars-notification {
display: flex;
align-items: center;
padding: 12px 15px;
border-radius: 6px;
margin-bottom: 15px;
border-left: 4px solid #2271b1;
background: #f0f6fc;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.07);
position: relative;
animation: wpaNotificationSlideIn 0.3s ease forwards;
}
.wp-allstars-notification-success {
background: #edfaef;
border-left-color: #00a32a;
}
.wp-allstars-notification-warning {
background: #fcf9e8;
border-left-color: #dba617;
}
.wp-allstars-notification-error {
background: #fcf0f1;
border-left-color: #d63638;
}
.wp-allstars-notification-icon {
margin-right: 12px;
width: 20px;
height: 20px;
background-repeat: no-repeat;
background-position: center;
flex-shrink: 0;
}
.wp-allstars-notification-content {
flex-grow: 1;
padding-right: 30px;
}
.wp-allstars-notification-title {
font-weight: 600;
margin-bottom: 3px;
}
.wp-allstars-notification-message {
font-size: 13px;
line-height: 1.5;
}
.wp-allstars-notification-dismiss {
position: absolute;
top: 12px;
right: 12px;
width: 20px;
height: 20px;
cursor: pointer;
opacity: 0.6;
transition: opacity 0.2s ease;
background: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20"><path d="M10 8.586l3.293-3.293a1 1 0 0 1 1.414 1.414L11.414 10l3.293 3.293a1 1 0 0 1-1.414 1.414L10 11.414l-3.293 3.293a1 1 0 0 1-1.414-1.414L8.586 10 5.293 6.707a1 1 0 0 1 1.414-1.414L10 8.586z"/></svg>') no-repeat center;
}
.wp-allstars-notification-dismiss:hover {
opacity: 1;
}
@keyframes wpaNotificationSlideIn {
from {
opacity: 0;
transform: translateY(-10px);
}
to {
opacity: 1;
transform: translateY(0);
}
}
/*
* Form Enhancements
*/
.wp-allstars-enhanced-ui input[type="text"],
.wp-allstars-enhanced-ui input[type="number"],
.wp-allstars-enhanced-ui input[type="password"],
.wp-allstars-enhanced-ui input[type="email"],
.wp-allstars-enhanced-ui input[type="url"],
.wp-allstars-enhanced-ui select,
.wp-allstars-enhanced-ui textarea {
border-radius: 4px;
border: 1px solid #8c8f94;
padding: 8px 12px;
box-shadow: none;
transition: border-color 0.2s ease, box-shadow 0.2s ease;
}
.wp-allstars-enhanced-ui input[type="text"]:focus,
.wp-allstars-enhanced-ui input[type="number"]:focus,
.wp-allstars-enhanced-ui input[type="password"]:focus,
.wp-allstars-enhanced-ui input[type="email"]:focus,
.wp-allstars-enhanced-ui input[type="url"]:focus,
.wp-allstars-enhanced-ui select:focus,
.wp-allstars-enhanced-ui textarea:focus {
border-color: #2271b1;
box-shadow: 0 0 0 1px #2271b1;
outline: none;
}
/*
* Responsive Enhancements
*/
@media screen and (max-width: 960px) {
.wp-allstars-enhanced-ui .wp-setting-main,
.wp-allstars-enhanced-ui .wp-allstars-toggle-main {
flex-direction: column;
align-items: flex-start;
}
.wp-allstars-enhanced-ui .wp-setting-left,
.wp-allstars-enhanced-ui .wp-allstars-toggle-left {
margin-bottom: 15px;
}
}
@media screen and (max-width: 782px) {
.wp-allstars-enhanced-ui .wp-setting-row,
.wp-allstars-enhanced-ui .wp-allstars-toggle {
padding: 15px;
}
.wp-allstars-enhanced-ui .wp-toggle-switch {
margin-bottom: 10px;
}
.wp-allstars-enhanced-ui .button {
font-size: 13px;
}
.wp-allstars-card-header,
.wp-allstars-card-content,
.wp-allstars-card-footer {
padding: 15px;
}
.wp-allstars-accordion-header {
padding: 12px 15px;
}
.wp-allstars-accordion-inner {
padding: 15px;
}
}
@media screen and (max-width: 600px) {
.wp-allstars-enhanced-ui .wp-allstars-wrap {
padding: 0 10px 10px;
}
.wp-allstars-card-header,
.wp-allstars-card-content,
.wp-allstars-card-footer {
padding: 12px;
}
.wp-allstars-card-title {
font-size: 15px;
}
.wp-allstars-notification {
padding: 10px 12px;
}
}

View File

@ -0,0 +1,184 @@
/**
* WP Allstars UI Enhancements
*
* Handles interactions for enhanced UI components
*/
(function($) {
'use strict';
// UI Components Object
var WPAallstarsUI = {
/**
* Initialize all UI components
*/
init: function() {
this.initAccordions();
this.initNotifications();
this.initCards();
// Initialize templates
this.initTemplates();
},
/**
* Initialize accordion functionality
*/
initAccordions: function() {
// Handle accordion toggle
$(document).on('click', '.wp-allstars-accordion-header', function() {
var $header = $(this);
var $content = $header.next('.wp-allstars-accordion-content');
var isExpanded = $header.attr('aria-expanded') === 'true';
// Toggle aria-expanded attribute
$header.attr('aria-expanded', !isExpanded);
// Toggle content visibility with animation
$content.slideToggle(200);
});
},
/**
* Initialize notification system
*/
initNotifications: function() {
// Handle notification dismissal
$(document).on('click', '.wp-allstars-notification-dismiss', function() {
$(this).closest('.wp-allstars-notification').fadeOut(200, function() {
$(this).remove();
});
});
// Auto-dismiss success notifications after 5 seconds
setTimeout(function() {
$('.wp-allstars-notification-success').fadeOut(300, function() {
$(this).remove();
});
}, 5000);
},
/**
* Initialize card components
*/
initCards: function() {
// Add any card-specific interactions here
$('.wp-allstars-card').on('mouseenter', function() {
$(this).addClass('wp-allstars-card-hover');
}).on('mouseleave', function() {
$(this).removeClass('wp-allstars-card-hover');
});
},
/**
* Initialize Underscore.js templates
*/
initTemplates: function() {
// Only proceed if wp.template is available (WordPress admin)
if (typeof wp !== 'undefined' && wp.template) {
// Store template functions for easy access
this.templates = {
accordion: wp.template('wp-allstars-accordion'),
card: wp.template('wp-allstars-card'),
notification: wp.template('wp-allstars-notification')
};
}
},
/**
* Create an accordion
*
* @param {Object} data Accordion data with id, title, and content
* @param {jQuery|String} target Where to append the accordion
* @return {jQuery} The created accordion element
*/
createAccordion: function(data, target) {
if (!this.templates || !this.templates.accordion) {
return $('<div>').text('Template not available');
}
var $accordion = $(this.templates.accordion(data));
if (target) {
if (typeof target === 'string') {
$(target).append($accordion);
} else {
target.append($accordion);
}
}
return $accordion;
},
/**
* Create a card
*
* @param {Object} data Card data with header, content, footer, and icon
* @param {jQuery|String} target Where to append the card
* @return {jQuery} The created card element
*/
createCard: function(data, target) {
if (!this.templates || !this.templates.card) {
return $('<div>').text('Template not available');
}
var $card = $(this.templates.card(data));
if (target) {
if (typeof target === 'string') {
$(target).append($card);
} else {
target.append($card);
}
}
return $card;
},
/**
* Create a notification
*
* @param {Object} data Notification data with type, title, and message
* @param {jQuery|String} target Where to append the notification
* @return {jQuery} The created notification element
*/
createNotification: function(data, target) {
if (!this.templates || !this.templates.notification) {
return $('<div>').text('Template not available');
}
// Set default type if not provided
data.type = data.type || 'info';
var $notification = $(this.templates.notification(data));
if (target) {
if (typeof target === 'string') {
$(target).prepend($notification);
} else {
target.prepend($notification);
}
// Auto-dismiss success notifications
if (data.type === 'success') {
setTimeout(function() {
$notification.fadeOut(300, function() {
$(this).remove();
});
}, 5000);
}
}
return $notification;
}
};
// Initialize on document ready
$(document).ready(function() {
// Initialize UI components
WPAallstarsUI.init();
// Make UI components available globally for use elsewhere
window.WPAallstarsUI = WPAallstarsUI;
});
})(jQuery);

View File

@ -0,0 +1,60 @@
<?php
/**
* WP ALLSTARS Sync Guard
*
* Prevents plugin loading during sync operations to avoid fatal errors.
*
* @package WP_ALLSTARS
* @since 0.2.3.1
*/
if (!defined('ABSPATH')) {
exit;
}
/**
* Class responsible for detecting sync operations and preventing plugin loading
*/
class WP_Allstars_Sync_Guard {
/**
* Flag file name for sync operations
*/
const SYNC_FLAG_FILE = '.syncing';
/**
* Check if sync is in progress
*
* @return bool Whether sync is in progress
*/
public static function is_sync_in_progress() {
$flag_file = plugin_dir_path(dirname(__FILE__)) . self::SYNC_FLAG_FILE;
return file_exists($flag_file);
}
/**
* Handle sync mode by showing admin notice and preventing plugin loading
*
* @return bool True if sync is in progress, false otherwise
*/
public static function handle_sync_mode() {
if (self::is_sync_in_progress()) {
// Add admin notice
add_action('admin_notices', array(__CLASS__, 'display_sync_notice'));
// Return true to indicate plugin should not continue loading
return true;
}
return false;
}
/**
* Display sync in progress notice
*/
public static function display_sync_notice() {
echo '<div class="notice notice-warning is-dismissible">';
echo '<p><strong>WP Allstars:</strong> Plugin files are currently syncing. The plugin functionality is temporarily disabled to prevent errors. Please try again in a moment.</p>';
echo '</div>';
}
}

View File

@ -0,0 +1,176 @@
<?php
/**
* WP Allstars UI Enhancements
*
* Responsible for enhancing the WordPress admin interface with improved UI components
* like cards, panels, buttons, and responsive design elements.
*
* @package WP_ALLSTARS
* @version v0.2.3.3
*/
if (!defined('WPINC')) {
exit;
}
class WP_Allstars_UI_Enhancements {
/**
* Constructor
* Initialize hooks and settings
*/
public function __construct() {
// Register scripts and styles
add_action('admin_enqueue_scripts', array($this, 'enqueue_assets'));
// Add body class for enhanced UI
add_filter('admin_body_class', array($this, 'add_body_class'));
// Initialize UI components
$this->init_components();
}
/**
* Enqueue CSS and JavaScript assets
*/
public function enqueue_assets($hook) {
// Only load on WP Allstars pages
if (strpos($hook, 'wp-allstars') === false) {
return;
}
// Already registered in main plugin file, but ensure they're enqueued
wp_enqueue_style('wp-allstars-admin');
wp_enqueue_script('wp-allstars-admin');
// Add UI enhancements script
wp_enqueue_script(
'wp-allstars-ui-enhancements',
plugin_dir_url(dirname(__FILE__)) . 'admin/js/wp-allstars-ui-enhancements.js',
array('jquery', 'wp-allstars-admin'),
WP_ALLSTARS_VERSION,
true
);
// Add enhanced UI styles
wp_enqueue_style(
'wp-allstars-ui-enhancements',
plugin_dir_url(dirname(__FILE__)) . 'admin/css/wp-allstars-ui-enhancements.css',
array('wp-allstars-admin'),
WP_ALLSTARS_VERSION
);
// Localize script with settings
wp_localize_script('wp-allstars-ui-enhancements', 'wpAllstarsUI', array(
'ajaxurl' => admin_url('ajax.php'),
'nonce' => wp_create_nonce('wp_allstars_ui_nonce'),
));
}
/**
* Add body class for enhanced UI
*/
public function add_body_class($classes) {
if (isset($_GET['page']) && strpos($_GET['page'], 'wp-allstars') !== false) {
$classes .= ' wp-allstars-enhanced-ui';
}
return $classes;
}
/**
* Initialize UI components
*/
private function init_components() {
// Add accordion functionality
add_action('admin_footer', array($this, 'render_accordion_template'));
// Add card component
add_action('admin_footer', array($this, 'render_card_template'));
// Add notification system
add_action('admin_footer', array($this, 'render_notification_template'));
}
/**
* Render accordion template
*/
public function render_accordion_template() {
// Only on WP Allstars pages
if (!isset($_GET['page']) || strpos($_GET['page'], 'wp-allstars') === false) {
return;
}
?>
<script type="text/html" id="tmpl-wp-allstars-accordion">
<div class="wp-allstars-accordion" role="tablist">
<div class="wp-allstars-accordion-header" role="tab" id="accordion-header-{{data.id}}" aria-expanded="false">
<div class="wp-allstars-accordion-title">{{data.title}}</div>
<div class="wp-allstars-accordion-icon"></div>
</div>
<div class="wp-allstars-accordion-content" role="tabpanel" aria-labelledby="accordion-header-{{data.id}}">
<div class="wp-allstars-accordion-inner">
{{{data.content}}}
</div>
</div>
</div>
</script>
<?php
}
/**
* Render card template
*/
public function render_card_template() {
// Only on WP Allstars pages
if (!isset($_GET['page']) || strpos($_GET['page'], 'wp-allstars') === false) {
return;
}
?>
<script type="text/html" id="tmpl-wp-allstars-card">
<div class="wp-allstars-card">
<# if (data.header) { #>
<div class="wp-allstars-card-header">
<# if (data.icon) { #>
<div class="wp-allstars-card-icon">{{{data.icon}}}</div>
<# } #>
<div class="wp-allstars-card-title">{{data.header}}</div>
</div>
<# } #>
<div class="wp-allstars-card-content">
{{{data.content}}}
</div>
<# if (data.footer) { #>
<div class="wp-allstars-card-footer">
{{{data.footer}}}
</div>
<# } #>
</div>
</script>
<?php
}
/**
* Render notification template
*/
public function render_notification_template() {
// Only on WP Allstars pages
if (!isset($_GET['page']) || strpos($_GET['page'], 'wp-allstars') === false) {
return;
}
?>
<script type="text/html" id="tmpl-wp-allstars-notification">
<div class="wp-allstars-notification wp-allstars-notification-{{data.type}}">
<div class="wp-allstars-notification-icon"></div>
<div class="wp-allstars-notification-content">
<# if (data.title) { #>
<div class="wp-allstars-notification-title">{{data.title}}</div>
<# } #>
<div class="wp-allstars-notification-message">{{data.message}}</div>
</div>
<div class="wp-allstars-notification-dismiss"></div>
</div>
</script>
<?php
}
}

View File

@ -6,73 +6,108 @@
* site performance, improve workflow, and provide recommendations for plugins and hosting. * site performance, improve workflow, and provide recommendations for plugins and hosting.
* *
* @package WP_ALLSTARS * @package WP_ALLSTARS
* @version v0.2.3 * @version v0.2.3.3
* *
* Plugin Name: WP ALLSTARS Plugin * Plugin Name: WP Allstars
* Plugin URI: https://www.wpallstars.com * Plugin URI: https://wpallstars.com
* Description: WP ALLSTARS Plugin for WordPress. Speed Matters. * Description: A superstar stack of premium WordPress functionality, designed for SEO pros.
* Version: v0.2.3 (Beta) * Author: Marcus Quinn
* Author: WP ALLSTARS * Author URI: https://wpallstars.com
* Author URI: https://www.wpallstars.com
* License: GPL-2.0+
* License URI: http://www.gnu.org/licenses/gpl-2.0.txt
* Text Domain: wp-allstars * Text Domain: wp-allstars
* Domain Path: /languages * Domain Path: /languages
* Requires at least: 5.0 * @version v0.2.3.3
* Requires PHP: 7.2 *
* WP Allstars is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 2 of the License, or
* any later version.
* Version: v0.2.3.3 (Beta)
*
* WP Allstars is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with WP Allstars. If not, see https://www.gnu.org/licenses/gpl-2.0.html.
*/ */
if (!defined('WPINC')) { if (!defined('WPINC')) {
exit; exit;
} }
// Define plugin version from the file header define('WP_ALLSTARS_VERSION', 'v0.2.3.3');
if (!function_exists('get_plugin_data')) {
require_once(ABSPATH . 'wp-admin/includes/plugin.php'); /**
* Load files safely by checking if they exist first
*/
function wp_allstars_require_if_exists($file) {
if (file_exists($file)) {
require_once $file;
return true;
}
return false;
} }
$plugin_data = get_plugin_data(__FILE__, false, false); /**
define('WP_ALLSTARS_VERSION', $plugin_data['Version']); * Check for sync operations before loading the plugin
*/
// Simple sync detection - check for .syncing file
if (file_exists(__DIR__ . '/.syncing')) {
// Only load the minimal code needed for admin notice
if (is_admin()) {
add_action('admin_notices', function() {
echo '<div class="notice notice-warning is-dismissible">';
echo '<p><strong>WP Allstars:</strong> Plugin files are currently syncing. The plugin functionality is temporarily disabled to prevent errors. Please try again in a moment.</p>';
echo '</div>';
});
}
// Exit early to prevent loading other files
return;
}
// Load the sync guard for future use and more advanced sync detection
wp_allstars_require_if_exists(plugin_dir_path(__FILE__) . 'includes/class-wp-allstars-sync-guard.php');
/** /**
* Plugin activation hook * Plugin activation hook
*/ */
function wp_allstars_activate() { function wp_allstars_activate() {
// Setup initial configuration when needed // Setup initial config
} }
register_activation_hook(__FILE__, 'wp_allstars_activate'); register_activation_hook(__FILE__, 'wp_allstars_activate');
/** // Core includes
* Load core plugin components wp_allstars_require_if_exists(plugin_dir_path(__FILE__) . 'includes/class-wp-allstars-auto-upload.php');
*/ wp_allstars_require_if_exists(plugin_dir_path(__FILE__) . 'includes/class-wp-allstars-admin-colors.php');
require_once plugin_dir_path(__FILE__) . 'includes/class-wp-allstars-auto-upload.php'; wp_allstars_require_if_exists(plugin_dir_path(__FILE__) . 'includes/class-wp-allstars-ui-enhancements.php');
// Load admin-specific components // Admin includes
if (is_admin()) { if (is_admin()) {
// Include manager classes $admin_includes = array(
require_once plugin_dir_path(__FILE__) . 'admin/includes/class-admin-manager.php'; 'admin/includes/class-admin-manager.php',
require_once plugin_dir_path(__FILE__) . 'admin/includes/class-settings-manager.php'; 'admin/includes/class-settings-manager.php',
require_once plugin_dir_path(__FILE__) . 'admin/includes/class-theme-manager.php'; 'admin/includes/class-theme-manager.php',
require_once plugin_dir_path(__FILE__) . 'admin/includes/class-workflow-manager.php'; 'admin/includes/class-workflow-manager.php',
require_once plugin_dir_path(__FILE__) . 'admin/includes/class-tools-manager.php'; 'admin/includes/class-tools-manager.php',
require_once plugin_dir_path(__FILE__) . 'admin/includes/class-hosting-manager.php'; 'admin/includes/class-hosting-manager.php',
require_once plugin_dir_path(__FILE__) . 'admin/includes/class-pro-plugins-manager.php'; 'admin/includes/class-pro-plugins-manager.php',
require_once plugin_dir_path(__FILE__) . 'admin/includes/class-plugin-manager.php'; 'admin/includes/class-plugin-manager.php',
require_once plugin_dir_path(__FILE__) . 'admin/includes/class-free-plugins-manager.php'; 'admin/includes/class-free-plugins-manager.php',
require_once plugin_dir_path(__FILE__) . 'admin/includes/class-readme-manager.php'; 'admin/includes/class-readme-manager.php'
);
// Initialize the admin manager foreach ($admin_includes as $file) {
add_action('plugins_loaded', array('WP_Allstars_Admin_Manager', 'init')); wp_allstars_require_if_exists(plugin_dir_path(__FILE__) . $file);
// Data files
require_once plugin_dir_path(__FILE__) . 'admin/data/pro-plugins.php';
require_once plugin_dir_path(__FILE__) . 'admin/data/readme.php';
// Legacy files (for backward compatibility)
require_once plugin_dir_path(__FILE__) . 'admin/settings.php';
} }
// Settings and data
wp_allstars_require_if_exists(plugin_dir_path(__FILE__) . 'admin/data/pro-plugins.php');
wp_allstars_require_if_exists(plugin_dir_path(__FILE__) . 'admin/data/readme.php');
// Admin settings
wp_allstars_require_if_exists(plugin_dir_path(__FILE__) . 'admin/settings.php');
}
/** /**
* Auto Upload feature initialization * Auto Upload feature initialization
@ -88,6 +123,17 @@ function wp_allstars_init_auto_upload() {
add_action('init', 'wp_allstars_init_auto_upload'); add_action('init', 'wp_allstars_init_auto_upload');
/** /**
* Initialize core plugin classes * Initialize core features
*/ */
$wp_allstars_auto_upload = new WP_Allstars_Auto_Upload(); function wp_allstars_init_features() {
// Initialize Admin Colors feature if the class exists
if (class_exists('WP_Allstars_Admin_Colors')) {
new WP_Allstars_Admin_Colors();
}
// Initialize UI Enhancements if the class exists
if (class_exists('WP_Allstars_UI_Enhancements')) {
new WP_Allstars_UI_Enhancements();
}
}
add_action('plugins_loaded', 'wp_allstars_init_features');