<commit_before># Forum v2.0 BETA #

A fully robust and powerful CakePHP forum plugin.

## Requirements ##

* CakePHP 1.3.x (Tested with 1.3.9)
* PHP 5.2.x, 5.3.x
* Utils Plugin - https://github.com/CakeDC/utils

## Documentation ##

Thorough documentation can be found here: http://milesj.me/code/cakephp/forum

## Installation ##

* Clone the repo into a folder called "forum" within your CakePHP's plugins directory
* Follow the instructions found in install.md

## Contributors ##

* <NAME> - Bulgarian
* <NAME> - German
* <NAME> - French
* <NAME> - Indonesian
* <NAME> - Russian
* <NAME> - Spanish

## Features ##

### Forums ###
* Forum wrappers and forum categories
* First tier sub-forums
* Activity and latest post tracking
* Auto-Lock old topics
* Enable/Disable post count increments
* Individual settings for reading, posting, replying, etc
* Access/Private specific forums
* Create topics or polls
* Reply to topics, or quote previous posts

### Moderation ###
* Moderators, Super Moderators and Admin levels
* Restrict moderators to specific forums
* Inline moderation and management
* Mass processing (Move, Delete, Close, etc)
* Ability to edit and manage users content

### Administration ###
* Full admin panel using CakePHP admin routes
* Requires the administration access level
* Can add, edit, order, delete forums and categories
* Manage all reported content
* Promote, demote, create access levels, staff and moderators
* Edit forum settings through the panel
* Manage all aspects and content

### Security ###
* Utilizes CakePHPs Auth and Security Components
* Advanced flood protection (Posts and Topics)
* Hourly post limitations
* Registration security wall
* Form protection against bots and hackers

### Miscellaneous ###
* BBCode support using the Decoda package
* Utilizes remember me features
* Mark topics as read (Session)
* Log created topics and posts (Session)
* Access level verification
* Report system for topics, posts and users
* Search through topics (Title and Post)
* RSS feeds for each forum

## Translating ##

If you would like to translate the forum into a new language, or fix a previous language.
Simply fork the repo and follow the instructions below, you will need to download PoEdit: http://www.poedit.net/

Once you have done that, just follow these steps.

1 - Open the program and go to File > New catalog from POT file
2 - Fill in the settings box with the following information

	Project: Forum Plugin
	Team: <NAME>
	Team Email: <EMAIL>
	Language: <Pick the language>
	Country: <Pick the country>
	Charset: UTF-8
	Source code: UTF-8
	Plural: <Leave blank>

3 - Hit ok
4 - Save the file as forum.po and place it anywhere
5 - Once saved, the program should populate with the text on the left
6 - Translate the sentences on the left by typing in the translation box in the bottom
7 - When you come across text with the %s and %d symbols, that means those symbols will be replaced with dynamic data

	Example:
	%d = Integer/Number
	%s = Text/String

	"The forum %s has been deleted, and all its forum categories have been moved!"
	"The forum General Discussion has been deleted, and all its forum categories have been moved!"

So those ARE REQUIRED to work correctly, just place those symbols where they would be within the translated string.
You may find some others like %count% and %total%; leave those as they are as well.

8 - When you are done, simply save the file
9 - You should now have 2 files, a .po and a .mo
10 - Open up the .po with Notepad and you should see the following

	#: /controllers/categories_controller.php:101
	msgid "A total of %d topic(s) have been permanently deleted"
	msgstr "<YOUR TRANSLATED VERSION HERE>"

11 - Create a folder for your language within the locale folder, based on the 3 character locale: http://www.loc.gov/standards/iso639-2/php/code_list.php
12 - Within the language folder, create the LC_MESSAGES folder and place the .po file within.
13 - Commit and push! Once done, I will review and merge with your changes.<commit_msg>Updating readme.<commit_after># Forum v2.0 BETA #

A fully robust and powerful CakePHP forum plugin.

## Requirements ##

* CakePHP 1.3.x (Tested with 1.3.9)
* PHP 5.2.x, 5.3.x
* Utils Plugin - https://github.com/CakeDC/utils

## Documentation ##

Thorough documentation can be found here: http://milesj.me/code/cakephp/forum

## Installation ##

* Clone the repo into a folder called "forum" within your CakePHP's plugins directory
* Follow the instructions found in install.md

## Contributors ##

* <NAME> - Bulgarian
* <NAME> - German
* <NAME> - French
* <NAME> - Indonesian
* <NAME> - Russian
* <NAME> - Spanish

## Features ##

### Forums ###
* Forum stations and child forums
* First tier sub-forums
* Activity and latest post tracking
* Auto-locking old topics
* Enable/Disable post count increments
* Individual settings for reading, posting, replying, etc
* Access/Private specific forums
* Create topics or polls
* Reply to topics, or quote previous posts

### Moderation ###
* Moderators, Super Moderators and Admin levels
* Restrict moderators to specific forums
* Inline moderation and management
* Mass processing (Move, Delete, Close, etc)
* Ability to edit and manage users content

### Administration ###
* Full admin panel using CakePHP admin routes
* Requires the administration access level
* Can add, edit, order, delete forums and categories
* Manage all reported content
* Promote, demote, create access levels, staff and moderators
* Edit forum settings through the panel
* Manage all aspects and content

### Security ###
* Utilizes CakePHPs Auth and Security Components
* Advanced flood protection (Posts and Topics)
* Hourly post limitations
* Registration security wall
* Form protection against bots and hackers

### Miscellaneous ###
* BBCode support using the Decoda package
* Utilizes remember me features
* Mark topics as read (Session)
* Log created topics and posts (Session)
* Access level verification
* Report system for topics, posts and users
* Search through topics (Title and Post)
* RSS feeds for each forum

## Translating ##

If you would like to translate the forum into a new language, or fix a previous language.
Simply fork the repo and follow the instructions below, you will need to download PoEdit: http://www.poedit.net/

Once you have done that, just follow these steps.

1 - Open the program and go to File > New catalog from POT file
2 - Fill in the settings box with the following information

	Project: CakePHP Forum Plugin
	Team: <NAME>
	Team Email: <EMAIL>
	Language: <Pick the language>
	Country: <Pick the country>
	Charset: UTF-8
	Source code: UTF-8
	Plural: <Leave blank>

3 - Hit ok
4 - Save the file as forum.po and place it anywhere
5 - Once saved, the program should populate with the text on the left
6 - Translate the sentences on the left by typing in the translation box in the bottom
7 - When you come across text with the %s and %d symbols, that means those symbols will be replaced with dynamic data

	Example:
	%d = Integer/Number
	%s = Text/String

	"The forum %s has been deleted, and all its forum categories have been moved!"
	"The forum General Discussion has been deleted, and all its forum categories have been moved!"

So those ARE REQUIRED to work correctly, just place those symbols where they would be within the translated string.
You may find some others like %count% and %total%; leave those as they are as well.

8 - When you are done, simply save the file
9 - You should now have 2 files, a .po and a .mo
10 - Open up the .po with Notepad and you should see the following

	#: /controllers/categories_controller.php:101
	msgid "A total of %d topic(s) have been permanently deleted"
	msgstr "<YOUR TRANSLATED VERSION HERE>"

11 - Create a folder for your language within the locale folder, based on the 3 character locale: http://www.loc.gov/standards/iso639-2/php/code_list.php
12 - Within the language folder, create the LC_MESSAGES folder and place the files within.
13 - Commit and push! Once done, I will review and merge with your changes.
{'fraction_non_alphanumeric': 0.07363332093715136, 'fraction_numerical': 0.009669021941242098, 'mean_word_length': 4.1519795657726695, 'pattern_counts': {'":': 0, '<': 27, '<?xml version=': 0, '>': 29, 'https://': 2, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2668998', 'n_tokens_mistral': 2283, 'n_tokens_neox': 2169, 'n_words': 1138}