mikhnyuk / fresns

Fresns core library: Cross-platform general-purpose multiple content forms social network service software

About Fresns

Fresns is a free and open source social network service software, a general-purpose community product designed for cross-platform, and supports flexible and diverse content forms. It conforms to the trend of the times, satisfies a variety of operating scenarios, is more open and easier to re-development.

• Users should read the installation and operating documentation.
• Extensions developers should read the extension documentation and database structure.
• For client developers (web or app), please read the API reference documentation.

Server Requirements

Environment	Services
Web Server Choose any one	Nginx Apache Caddy IIS
PHP Version	PHP 8.1 or higher
PHP Extensions	fileinfo
PHP Functions	putenv, symlink, proc_open, passthru
Package Manager	Composer 2.5 or higher
Database and Version Choose any one	MySQL 5.7 ~ 8.x MariaDB 10.3 ~ 11.x PostgreSQL 11.x ~ 15.x SQL Server 2016(13.x) ~ 2022(16.x) SQLite 3.9 及以上

Installation and Using

This repository is an R & D code repository without "vendor" reference library files. If you use this repository code package to install, you need to execute the composer command based on the command line to install "vendor" reference library files. If you feel troublesome, you can also download the full version of the installation package from the official website. The installation package on the official website already contains reference library files, so there is no need to perform command-line installation.

Deployment Process

1. Download the code package of the repository release, upload it to the business server and decompress it.
2. Execute the command line in the "main program root directory", Download the vendor package file.
   • Development deployment: composer install
   • Production deployment: composer install --optimize-autoloader --no-dev
3. Execute the php artisan command under the "main program root directory" to configure the manager.
   • php artisan vendor:publish --provider="Fresns\PluginManager\Providers\PluginServiceProvider"
   • php artisan vendor:publish --provider="Fresns\ThemeManager\Providers\ThemeServiceProvider"
   • php artisan vendor:publish --provider="Fresns\MarketManager\Providers\MarketServiceProvider"
4. Configure the web server according to the the installation tutorial on the official website.
5. Visit the /install page to do the installation.

Contributing

Thank you for considering contributing to the Fresns core library! The contribution guide can be found in the Fresns documentation.

Code of Conduct

In order to ensure that the Fresns community is welcoming to all, please review and abide by the Code of Conduct.

Security Vulnerabilities

If you discover a security vulnerability within Fresns, please send an e-mail to Taylor Otwell via [e-mail]. All security vulnerabilities will be promptly addressed.

License

Fresns is open-sourced software licensed under the Apache-2.0 license.