Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Installation quickstart


  • Web browser compatible with JQuery (almost all !)
  • A server with:
    • php >= 5.3.0 (Slim framework dependency)
    • apache server with mod_rewrite and .htaccess enabled (AllowOverride All)
    • write access to the phpfreechat-2.1.1/server/data/ and phpfreechat-2.1.1/server/log/ folder (777 or write permission for the web server)
  • No database needed !

Quick start

Download and unzip it in the root folder of your Web server.

JQuery should be included in your html <head> before the phpfreechat code:

  <script src="/phpfreechat-2.1.1/client/lib/jquery-1.8.2.min.js" type="text/javascript"></script>

Include the phpfreechat plugin in your html <head>:

  <link rel="stylesheet" type="text/css" href="/phpfreechat-2.1.1/client/themes/default/pfc.min.css" />
  <script src="/phpfreechat-2.1.1/client/pfc.min.js" type="text/javascript"></script>

Add this piece of HTML in your <body> where you want the chat to be displayed:

<div id="mychat"><a href="">Creating chat rooms everywhere - phpFreeChat</a></div>

Then add this piece of code just after (it will hook the chat on the page):

<script type="text/javascript">
  $('#mychat').phpfreechat({ serverUrl: '/phpfreechat-2.1.1/server' });

Themes customization

phpfreechat is released with few themes. You can choose which one you want to use:

  • default
  • carbon
  • gamer
  • phpfreechat
  • phpfreechat-mini

To select the theme, you only have to change one line in your html <head>. To use the default theme:

  <link rel="stylesheet" type="text/css" href="/phpfreechat-2.1.1/client/themes/default/pfc.min.css" />

or this code for carbon theme:

  <link rel="stylesheet" type="text/css" href="/phpfreechat-2.1.1/client/themes/carbon/pfc.min.css" />