A free, open-source, self-hosted forum software based on the Laravel PHP Framework.
PHP HTML CSS CoffeeScript Other
Latest commit 2da2c11 Dec 9, 2016 @lianguan lianguan Replace hhvm with 7.1

README.md

Hifone

StyleCI Build Status Software License

Screenshot

Hifone is a free, open-source, self-hosted forum software based on the Laravel PHP Framework.

Features

This package is currently in (very-)alpha stage, so all of the following features may or may not work yet. However, feel free to post issues and features requests here . We will try to fix and improve the package as fast as we can based on your help!

  • Fast and simple
  • Beautiful and responsive
  • Register & Login via OAuth
  • Image upload
  • Avatars
  • Credits
  • Roles & Permissions
  • Notifications
  • Markdown & Emoj
  • Tags
  • Advertisements
  • RSS Feeds
  • Localization: language files, time zone and UTF-8 support
  • Pjax support

Requirements

There are a few things that you will need to have set up in order to run Gitamin:

  • A web server: Nginx, Apache (with mod_rewrite), or Lighttpd
  • PHP 5.6.4+ with the following extensions: mbstring, pdo_mysql
  • MySQL or PostgreSQL
  • Composer

Installation

By default Hifone comes with a .env.example file. You'll need to rename this file to just .env regardless of what environment you're working on.

If you're using SQLite then your .env file should not contain a DB_HOST key. You'll also need to touch ./database/hifone.sqlite and give it the required permissions.

Directories within the storage and the bootstrap/cache directories should be writable by your web server or Hifone will not run.

Step 1: Shell

git clone https://github.com/Hifone/Hifone
cd Hifone

cp .env.example .env
vi .env  # write database settings

composer install --no-dev -o

php artisan hifone:install

chmod -R 777 storage
chmod -R 777 bootstrap/cache
chmod -R 777 public/uploads

If you have problems to open the Page, enter the Following:

php artisan vendor:publish

Step 2: Browser

Now go to http://your_site_domain/ and have fun!

Installing Hifone with Docker

$ git clone https://github.com/Hifone/Docker.git hifone-docker
$ cd hifone-docker
$ docker build -t hifone --rm .
$ docker run -it --rm -p 0.0.0.0:8081:80 hifone
$ /run.sh

Now go to http://127.0.0.1:8081 (linux) or http://192.168.99.100:8081 (mac) and have fun!

You can find more information at Install Hifone

Additional Settings

On the Admin Panel you can add some additional Settings

meta_author - Set Metadata for Authors
meta_keywords - Set Metadata for Keywords
footer_html - Write some HTML stuff for Footer
new_thread_dropdowns - With this, you can add some DropDown Items for the "New Thread" Button
site_about - This is for Adding a Subtitle for the Website

Upgrading

php artisan hifone:update

Development

These extra dependencies are required to develop Hifone:

  • Node.js
  • Bower
  • Gulp
npm install
bower install
gulp

If you're making a lot of changes, you'll find that running gulp watch will really help you out!

Demo

Hifone website.

License

Hifone is open-sourced software licensed under the MIT license