Skip to content

Latest commit

 

History

History
281 lines (199 loc) · 17.1 KB

README.md

File metadata and controls

281 lines (199 loc) · 17.1 KB

Screenshot of Laragon Dashboard Logo Laragon Dashboard

Welcome to the Laragon Dashboard !

Attention developers! Are you tired of sifting through a cluttered directory to find your projects and files? Look no further than our customized user interface designed specifically for your Laragon server.

🚀 Pros & Devs love Laragon and for sure will love our laragon Dashboard since the combination of that stack makes it unbeatable!


Screenshot of Laragon Dashboard Promo Screenshot of Laragon Dashboard Page Screenshot of Laragon Dashboard Mailbox Screenshot of Laragon Dashboard Mailbox Open Email

Screenshot of Laragon Dashboard Server Vitals


Our UI automatically detects any projects and directories within your root directory, making it easy to manage your work. Plus, we've included an automated auto-detection for popular frameworks like WordPress, Laravel, and Symfony. We've gone the extra mile to provide a visually appealing and intuitive interface that's easy to navigate, so you can spend more time coding and less time searching for files. And with a responsive design, you can access our UI on any device.

Screenshot of Laragon Dashboard Logo Key Features

Clean and Modern Design Efficient Management Seamless on Any Device Auto-Detection
Provides a clean and modern design that is both easy on the eyes and easy to navigate. Automated auto-detection for popular frameworks like WordPress, Laravel, and Symfony. Designed to work seamlessly on any device, from desktop computers to mobile phones. Automated auto-detection for popular frameworks like WordPress, Laravel, and Symfony.

Note: bigger better features coming soon just waiting for the next release of Laragon


Screenshot of Laragon Dashboard Logo How to use

  1. Replace the default index.php file in your Laragon root directory with our customized index.php file.
  2. your laragon hostname template (.local) will be automatically detected and served here (line 249 is your friend)
   function getLocalSites($server = 'apache', $ignoredFiles = ['.', '..', '00-default.conf']): array{}
  1. Upload the icons and CSS files to the assets directory (or simply import them as is).

  2. add whatever directories that you don't intend to expose publicly (line 316)

$ignore_dirs = array('.', '..', 'logs', 'access-logs', 'vendor', 'favicon_io', 'assets');
$domainSuffix = '.test'; // Set this according to user preference or configuration

switch (true) {
    case file_exists($host . '/wp-admin'):
        $app_name = ' Wordpress ';
        $avatar = 'assets/Wordpress.png';
        $admin_link = '<a href="' . $url . '://' . htmlspecialchars($host) . $domainSuffix . '/wp-admin" target="_blank"><small style="font-size: 8px; color: #cccccc;">' . $app_name . '</small><br>Admin</a>';
        break;

Screenshot of Laragon Dashboard Logo Feedback

  • We're confident that our dashboard will enhance your development experience and streamline your workflow. Try it out today and let us know what you think! Join the discussions and let's make Laragon Dashboard the best it can be.
  • Don't forget to star the project to stay up-to-date on future improvements, and please share your feedback with us. We're always looking for ways to make our dashboard even better for you.

📢️ Thanks everyone for your support and words of love for Laragon Dashboard, I am committed to creating the best Stack Dashboard to support the ever growing community of Laragon

Screenshot of Laragon Dashboard Logo Changelog

What's New in 2.3.9 November 04, 2024

  • The 2.3.9 update provides a refined, polished look to the Laragon Dashboard, emphasizing a cohesive design for server controls, a seamless background, and a footer that remains anchored at the bottom of the viewport. This update resolves previous issues with document loading and enhances the visual coherence of the interface, offering a more professional and user-friendly experience.
  • Footer and Layout Adjustments
  • Server Controls Card Redesign yet still dependent on the awaiting Laragon version release
  • Background Coverage Fix
  • Additional UI Enhancements
  • Version update to 2.3.9
Version 2.3.8 June 16,2024 ### Added - Real-time server vitals fetching and dynamic UI updates (class anchors for now waiting for Laragon7 to see how this changes). - New UI elements and functionality related to server controls in `index.php`. - New styles for buttons, cards, and modals in `assets/style.css`. - Added a class to start and stop the server (not yet functional)

Changed

  • Refactored email handling in assets/inbox/inbox.php and assets/inbox/open_email.php.
  • Updated JavaScript in index.php to dynamically update charts with real-time data.

Fixed

  • Improved error handling for email file reading in assets/inbox/open_email.php.
  • Corrected directory path handling in assets/inbox/inbox.php.

Removed

  • Deprecated styles and unused CSS classes in assets/style.css.
Version 2.3.5 June 06,2024
  • Dynamic Host Configuration fine-tuned #19
  • Dynamic Emails Directory Detection #19
  • Removed secondary Header from the Mailbox
Version 2.3.4 June 06,2024 - Language Loading and Selection: Added functionality to load language files and detect user language preference. - Server Status Display: Added functions to display server uptime, memory usage, and disk usage. - Query Parameter Handling: Improved handling of incoming query parameters. - PHP and Apache Extension Retrieval: Added functionality to retrieve PHP extensions and Apache modules. - PHP Version Checking: Fetches the latest PHP version and compares it with the current version running on the server. - Server Information Retrieval: Gathers information about the server environment, including versions of HTTP server, OpenSSL, PHP, and Xdebug. - MySQL Version Retrieval: Added function to retrieve the MySQL version. - PHP Download Links: Generates download and changelog links for specific PHP versions. - Site Directory Determination: Determines the directory path for server-specific site configuration based on the server software. - WordPress Core Update Detection: Added functionality to detect if WordPress has any updates. (Plugins and Themes in the next version) - Local Sites Retrieval: Fetches configuration details for local sites based on server configuration files. - HTML Links Rendering: Renders HTML links for local sites with XSS prevention and includes control buttons for starting and stopping applications.
Version in 2.3.3 · May 31, 2024

(major release re-written ground-up with languages support, mailbox and stack's Vitals )

Introduced Language Translation Support

  • Implemented language translation support using JSON files.
  • Fixed (de, en, es, fr, pt and tl for now)

Introduced Breadcrumbs and Tabs: Introduced breadcrumb headers for each tab for better navigation.

These tabs are now in place:

  • Servers Tab
  • Mailbox Tab
  • Server or Stack Vitals

Other Updates and Improvements

  • HTML Structure: Refactored HTML structure to include header for each tab within the tab content. Updated navigation tabs to include servers, mailbox, and vitals.
  • CSS Styling: Improved overall styling with Bootstrap 5. Added custom styles for tabs, headers, and overview cards.
  • JavaScript Functionality: Enhanced tab switching functionality with jQuery. Added language selector change event to reload the page with the selected language.
  • PHP Code Enhancements: Refactored server information retrieval and display logic. Enhanced error handling for server vitals data retrieval.
Changes in Version 2.2.1
  • Improved Error Handling and Security:
  • Enhanced handleQueryParameter function with input validation and escaping of outputs to prevent XSS attacks.

Updates and Enhancements:

  • Improved getServerExtensions function to handle Apache modules correctly.
  • Updated getPhpVersion function to retrieve the latest PHP version from the official PHP website.
  • Improved getSQLVersion function to handle MySQL version retrieval correctly.
  • Enhanced getLocalSites function to ignore specific directories and files.
  • Updated renderLinks function to prevent XSS attacks.
  • Improved getSiteDir function to handle server software detection correctly.
  • Removed the check for wp-admin when detecting Laravel.
  • Removed the "Admin" link from the HTML output for Laravel applications.
Changes in Version 2.2

Code Organization Separation of Concerns: Functions related to server status, PHP version checks, and other utilities have been suggested to be moved to separate files, enhancing maintainability and readability.

Error Handling Robust Error Management: Enhanced error handling across the script, including the use of try-catch blocks for operations prone to failure, such as file access and external API calls. Database Connection Handling: Improved the management of database connections by introducing exception handling to gracefully manage connection errors and prevent the application from crashing.

Security Enhancements Input Sanitization: Strengthened the sanitization and validation of user inputs and external data manipulations, especially in URLs, file paths, and database queries, to prevent security vulnerabilities like SQL injection and XSS. Sensitive Information: Increased caution around the display of sensitive information, ensuring that debugging and sensitive data are not exposed in the production environment.

Performance Considerations Data Caching: Introduced caching strategies for frequently accessed data that doesn't change often, reducing the load on the server and speeding up response times. Lazy Loading: Recommended lazy loading for non-critical resources to improve initial page load times.

Front-end Enhancements JavaScript Graceful Degradation: Ensured that essential functionalities of the web application do not rely solely on JavaScript and work even when JavaScript is disabled.

Accessibility and Usability WCAG Compliance: Improved accessibility by ensuring that the user interface complies with WCAG guidelines, including screen reader support, keyboard navigability, and proper contrast ratios. Alt Attributes: Added alt attributes to all images for better accessibility.

Responsive Design Ensured that the web application's layout is responsive and performs well across different devices using media queries.

Modern PHP Features PHP 7.4 + Features: Leveraged modern PHP features such as typed properties, arrow functions, and null coalescing assignment operators where appropriate.

Specific Code Refactoring These updates collectively enhance the security, performance, maintainability, and user experience of your Laragon server index page.

Changes in Version 2.1.5 ecurity: Added input validation and output escaping to prevent XSS and other security vulnerabilities. Error Handling: Improved error handling with try-catch blocks and better error checking for file operations. Readability: Refactored some functions for better readability and maintainability. Modularity: Made the code more modular and easy to extend or modify.
Changes in Version 2.1.3 -Added Python based project detection case: The switch case for detecting Python based projects has been implemented, allowing the system to recognize Python projects within the Laragon root directory. This enables specific handling and customization for Python projects.

-Added Python project icon to the assets: A new icon representing Python projects has been added to the assets directory. This icon enhances the visual representation and differentiation of Python projects within the Laragon Server Index Page.

Changes in Version 2.1.2 - Updated UI for enhanced user experience: The user interface of the Laragon Server Index Page has been refined with improved styling, layout adjustments, and optimized visual elements. These enhancements aim to provide a more user-friendly and visually appealing experience for developers.

-Performance optimizations: Several optimizations have been implemented to improve the overall performance and loading speed of the Laragon Server Index Page. These optimizations ensure faster navigation and smoother interactions within the index page.

Changes in Version 1.2.0 - Updated UI for enhanced user experience: The user interface of the Laragon Server Index Page has been refined with improved styling, layout adjustments, and optimized visual elements. These enhancements aim to provide a more user-friendly and visually appealing experience for developers. -Performance optimizations: Several optimizations have been implemented to improve the overall performance and loading speed of the Laragon Server Index Page. These optimizations ensure faster navigation and smoother interactions within the index page. - Improved framework detection: The framework detection algorithm has been enhanced to automatically detect popular frameworks such as Laravel, Symfony, and WordPress within the Laragon root directory. This results in more accurate identification and tailored handling of framework-specific projects.
Changes in Version 1.1.0 - Initial release: The Laragon Server Index Page was initially introduced, providing a user-friendly and efficient interface for managing projects within the Laragon server environment. The index page included features like project visualization, basic file operations, and framework detection for Laravel.

For full details and former releases, check out the changelog.


And don't worry, we've taken care of cleaning up all PHP calls, providing error responses, and removing redundant codes.

This is good enough to be the official index page of Laragon to replace the vanilla Laragon server index page, and offers several key features that make it an essential tool for developers:

Stay ahead of the curve with Laragon Dashboard and connect with me and with the other contributors of the Laragon Dashboard project. We now support language files so feel free to contribute and send us your translations to include them in the next upcoming releases.

We're confident that our dashboard will enhance your development experience and streamline your workflow. Try it out today and let us know what you think!

Don't forget to star the project to stay up-to-date on future improvements, and please share your feedback with us. We're always looking for ways to make our index page even better for you.


Screenshot of Laragon Dashboard Logo Get Involved

Whether you're a developer, system integrator, or enterprise user, you can trust that we did everything possible to make it as smooth and easy as 1,2,3 to set up our laragon Dashboard.

  • Give us a star on GitHub 👆
  • Fork the project on GitHub and contribute👆
  • 🚀 Do you like to code? You're more than welcome to contribute Join the Discussions!
  • 💡 Got a feature suggestion? Add your roadmap ideas

This project is licensed under the Attribution License.

This work by Tarek Tarabichi is licensed under CC BY 4.0

2023-2024 · Tarek Tarabichi 2tinteractive.com · Made with 💙