https://github.com/serial/php-browsercheck
Show some basic browser information
https://github.com/serial/php-browsercheck
browser support useragent
Last synced: 2 months ago
JSON representation
Show some basic browser information
- Host: GitHub
- URL: https://github.com/serial/php-browsercheck
- Owner: serial
- License: mit
- Created: 2024-06-14T12:33:35.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2024-06-17T15:22:50.000Z (11 months ago)
- Last Synced: 2024-06-18T09:44:00.176Z (11 months ago)
- Topics: browser, support, useragent
- Language: CSS
- Homepage: https://msn-systems.de/browsercheck/
- Size: 8.13 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Description
## Browsercheck
A simple tool to check the client browser version and operating system with some more details.
The Browser User-Agent is detected and displayed in a nice way with some extra information see [features](#features).
The user can take a screenshot of the information or send it directly via E-Mail (PHPMailer or PHP mail function) to a given address.
# Requirements
* Webserver or localhost with PHP 7.4 or higher
* Mailserver so send vie SMTP (Optional)
* Composer to install dependencies (required)
# Screenshot
Desktop and Mobile view
# Installation
1. Clone this repository
2. Run `composer install` to install dependencies
3. Copy `config.php.sample` to `config.php` and edit the settings
4. Choose if you want to use the PHPMailer or the integrated PHP mail function
5. Open the index.php file in your browser
# Alternative installation
1. Upload the files to your webserver
2. Install composer on your server and run `composer install --no-dev --optimize-autoloader` inside the project folder
3. Copy `config.php.sample` to `config.php` and set the settings
4. Open the index.php file in your browser
# Configuration / troubleshooting
* Settings need to be set in the `config.php` file
* A static testmail script is included to test a smtp connection via PHPMailer
* If you want to use SMTP with Google, Apple, Microsoft or Azure, please refer to the documentation of PHPMailer for further modules
* In production make sure to set the `DEBUG` setting to `false` to hide error messages, otherwise the ajax requests message will not show in the frontend
# Features
* Detects
* the browser and engine version
* the operating system
* the user's IP address
* the user's browser resolution
* the user's device type
* the user's browser preferred language
* Screenshot / Capture
* A button to take a screenshot / capture the information in a canvas
* The canvas is shown in a nice fancybox
* The fancybox provides a download button to save the image
* Send E-Mail
* The data can be sent directly to an E-Mail address
* You can choose to use a SMTP server or the PHP mail function
* The SMTP server settings can be configured in the config.php file
* Shows a message depending on the success or failure of the mail function
* Send email button is disabled after sending the mail
* Sendmail function is handled via ajax request
* Styled messages for success and error responses
* Shows a unique token which is also sent via mail and on the screenshot
* Optimized for mobile devices
# Dev Notes
- For updating the browser and device detection, you can use the composer package manager.
- You can easily update the WhichBrowser library by running the command `composer update whichbrowser/parser` in the project folder.
- Styling is done with LESS and compiled to CSS
# References
This project uses the following libraries
* **PHP**
* [WhichBrowser](https://github.com/WhichBrowser/Parser-PHP) (To interpret the browsers User-Agent string and identify latest browsers and devices)
* [PHPMailer](https://github.com/PHPMailer/PHPMailer) (Optional)
* **JS**
* jQuery (3.5.1)
* html2canvas (1.4.1)
* FancyBox (3.5.7)
* **CSS / Fonts**
* Fonts
* Open Sans (locally integrated Google Font)
* Roboto Mono (locally integrated Google Font)
* Icon Library
* Font Awesome Pro (6.5.2)