diff --git a/.hgignore b/.hgignore
index aaea3b6c6..42cd85ac7 100644
--- a/.hgignore
+++ b/.hgignore
@@ -146,7 +146,7 @@ external_stlport
.svn
thumbs.db
Thumbs.db
-.Sync*
+*.tpl.php
# build
code/nel/build/*
@@ -199,6 +199,16 @@ code/nel/tools/pacs/build_rbank/build_rbank
code/ryzom/common/data_leveldesign/leveldesign/game_element/xp_table/skills.skill_tree
code/ryzom/common/data_leveldesign/leveldesign/game_element/xp_table/xptable.xp_table
code/ryzom/tools/server/sql/ryzom_admin_default_data.sql
+code/ryzom/tools/server/ryzom_ams/drupal
+code/ryzom/tools/server/ryzom_ams/drupal_module/ryzommanage/ams_lib/autoload
+code/ryzom/tools/server/ryzom_ams/drupal_module/ryzommanage/ams_lib/configs
+code/ryzom/tools/server/ryzom_ams/drupal_module/ryzommanage/ams_lib/cron
+code/ryzom/tools/server/ryzom_ams/drupal_module/ryzommanage/ams_lib/img
+code/ryzom/tools/server/ryzom_ams/drupal_module/ryzommanage/ams_lib/plugins
+code/ryzom/tools/server/ryzom_ams/drupal_module/ryzommanage/ams_lib/smarty
+code/ryzom/tools/server/ryzom_ams/drupal_module/ryzommanage/ams_lib/translations
+code/ryzom/tools/server/ryzom_ams/drupal_module/ryzommanage/ams_lib/libinclude.php
+code/ryzom/tools/server/ryzom_ams/www/html/templates_c
# Linux server compile
code/ryzom/server/src/entities_game_service/entities_game_service
@@ -210,5 +220,6 @@ code/ryzom/server/src/ryzom_admin_service/ryzom_admin_service
code/ryzom/server/src/ryzom_naming_service/ryzom_naming_service
code/ryzom/server/src/ryzom_welcome_service/ryzom_welcome_service
code/ryzom/server/src/tick_service/tick_service
-# WebTT temp dir
+# WebTT temp dir
code/ryzom/tools/server/www/webtt/app/tmp
+code\ryzom\tools\server\ryzom_ams\old
diff --git a/code/nel/src/gui/widget_manager.cpp b/code/nel/src/gui/widget_manager.cpp
index 7cfe26a3e..4d7ada23d 100644
--- a/code/nel/src/gui/widget_manager.cpp
+++ b/code/nel/src/gui/widget_manager.cpp
@@ -3184,7 +3184,6 @@ namespace NLGUI
CWidgetManager::CWidgetManager()
{
LinkHack();
-
CStringShared::createStringMapper();
CReflectableRegister::registerClasses();
diff --git a/code/ryzom/client/client_default.cfg b/code/ryzom/client/client_default.cfg
index 05c0db137..1b45f294d 100644
--- a/code/ryzom/client/client_default.cfg
+++ b/code/ryzom/client/client_default.cfg
@@ -44,7 +44,7 @@ BackgroundDownloader = 0;
PatchServer = "";
PatchWanted = 0;
SignUpURL = "";
-StartupHost = "open.ryzom.com:40916";
+StartupHost = "shard.ryzomcore.org:40916";
StartupPage = "/login/r2_login.php";
InstallStatsUrl = "http://open.ryzom.com:50000/stats/stats.php";
CreateAccountURL = "";
diff --git a/code/ryzom/client/data/gamedev/interfaces_v3/help.xml b/code/ryzom/client/data/gamedev/interfaces_v3/help.xml
index 39cfb1af4..edfb8c19e 100644
--- a/code/ryzom/client/data/gamedev/interfaces_v3/help.xml
+++ b/code/ryzom/client/data/gamedev/interfaces_v3/help.xml
@@ -863,8 +863,10 @@
+
+ value="http://shard.ryzomcore.org/ams/index.php" />
+
+
+
+
+
+
-
-
-
-
-
-
-
-
diff --git a/code/ryzom/client/data/ssl_ca_cert.pem b/code/ryzom/client/data/ssl_ca_cert.pem
new file mode 100644
index 000000000..e69de29bb
diff --git a/code/ryzom/client/src/client_cfg.cpp b/code/ryzom/client/src/client_cfg.cpp
index 67016de37..782c6cc0d 100644
--- a/code/ryzom/client/src/client_cfg.cpp
+++ b/code/ryzom/client/src/client_cfg.cpp
@@ -327,13 +327,13 @@ CClientConfig::CClientConfig()
TexturesLoginInterface.push_back("texture_interfaces_v3_login");
DisplayAccountButtons = true;
- CreateAccountURL = "https://secure.ryzom.com/signup/from_client.php";
+ CreateAccountURL = "http://shard.ryzomcore.org/ams/index.php?page=register";
ConditionsTermsURL = "https://secure.ryzom.com/signup/terms_of_use.php";
- EditAccountURL = "https://secure.ryzom.com/payment_profile/index.php";
+ EditAccountURL = "http://shard.ryzomcore.org/ams/index.php?page=settings";
BetaAccountURL = "http://www.ryzom.com/profile";
- ForgetPwdURL = "https://secure.ryzom.com/payment_profile/lost_secure_password.php";
+ ForgetPwdURL = "http://shard.ryzomcore.org/ams/index.php?page=forgot_password";
FreeTrialURL = "http://www.ryzom.com/join/?freetrial=1";
- LoginSupportURL = "http://www.ryzom.com/en/support.html";
+ LoginSupportURL = "http://shard.ryzomcore.org/ams/index.php";
Position = CVector(0.f, 0.f, 0.f); // Default Position.
Heading = CVector(0.f, 1.f, 0.f); // Default Heading.
EyesHeight = 1.5f; // Default User Eyes Height.
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/assigned.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/assigned.php
new file mode 100644
index 000000000..8de17a9e2
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/assigned.php
@@ -0,0 +1,184 @@
+set(array('User' => $user_id, 'Ticket' => $ticket_id));
+ $assignation->create();
+ return "SUCCESS_ASSIGNED";
+ }else{
+ return "ALREADY_ASSIGNED";
+ }
+
+ }
+
+
+ /**
+ * Unassign a ticket being coupled to a user or return an error message.
+ * It will first check if the ticket is assigned, if this is indeed the case it will delete the 'assigned' entry.
+ * @param $user_id the id of the user we want to unassign from the ticket
+ * @param $ticket_id the id of the ticket.
+ * @return A string, if unassigning succeedded "SUCCESS_UNASSIGNED" will be returned, else "NOT_ASSIGNED" will be returned.
+ */
+ public static function unAssignTicket( $user_id, $ticket_id) {
+ $dbl = new DBLayer("lib");
+ //check if ticket is really assigned to that user
+ if( Assigned::isAssigned($ticket_id, $user_id)){
+ $assignation = new Assigned();
+ $assignation->set(array('User' => $user_id, 'Ticket' => $ticket_id));
+ $assignation->delete();
+ return "SUCCESS_UNASSIGNED";
+ }else{
+ return "NOT_ASSIGNED";
+ }
+
+ }
+
+ /**
+ * Get the (external) id of the user assigned to a ticket
+ * @param $ticket_id the Id of the ticket that's being queried
+ * @return The (external)id of the user being assigned to the ticket
+ */
+ public static function getUserAssignedToTicket($ticket_id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT ticket_user.ExternId FROM `assigned` JOIN `ticket_user` ON assigned.User = ticket_user.TUserId WHERE `Ticket` = :ticket_id", Array('ticket_id' => $ticket_id));
+ $user_id = $statement->fetch();
+ return $user_id['ExternId'];
+
+
+
+ }
+
+ /**
+ * Check if a ticket is already assigned (in case the user_id param is used, it will check if it's assigned to that user)
+ * @param $ticket_id the Id of the ticket that's being queried
+ * @param $user_id the id of the user, default parameter = 0, by using a user_id, it will check if that user is assigned to the ticket.
+ * @return true in case it's assigned, false in case it isn't.
+ */
+ public static function isAssigned( $ticket_id, $user_id = 0) {
+ $dbl = new DBLayer("lib");
+ //check if ticket is already assigned
+
+ if($user_id == 0 && $dbl->execute(" SELECT * FROM `assigned` WHERE `Ticket` = :ticket_id", array('ticket_id' => $ticket_id) )->rowCount() ){
+ return true;
+ }else if( $dbl->execute(" SELECT * FROM `assigned` WHERE `Ticket` = :ticket_id and `User` = :user_id", array('ticket_id' => $ticket_id, 'user_id' => $user_id) )->rowCount()){
+ return true;
+ }else{
+ return false;
+ }
+ }
+
+ ////////////////////////////////////////////Methods////////////////////////////////////////////////////
+
+ /**
+ * A constructor.
+ * Empty constructor
+ */
+ public function __construct() {
+ }
+
+
+ /**
+ * sets the object's attributes.
+ * @param $values should be an array of the form array('User' => user_id, 'Ticket' => ticket_id).
+ */
+ public function set($values) {
+ $this->setUser($values['User']);
+ $this->setTicket($values['Ticket']);
+ }
+
+
+ /**
+ * creates a new 'assigned' entry.
+ * this method will use the object's attributes for creating a new 'assigned' entry in the database.
+ */
+ public function create() {
+ $dbl = new DBLayer("lib");
+ $query = "INSERT INTO `assigned` (`User`,`Ticket`) VALUES (:user, :ticket)";
+ $values = Array('user' => $this->getUser(), 'ticket' => $this->getTicket());
+ $dbl->execute($query, $values);
+ }
+
+
+ /**
+ * deletes an existing 'assigned' entry.
+ * this method will use the object's attributes for deleting an existing 'assigned' entry in the database.
+ */
+ public function delete() {
+ $dbl = new DBLayer("lib");
+ $query = "DELETE FROM `assigned` WHERE `User` = :user_id and `Ticket` = :ticket_id";
+ $values = array('user_id' => $this->getUser() ,'ticket_id' => $this->getTicket());
+ $dbl->execute($query, $values);
+ }
+
+ /**
+ * loads the object's attributes.
+ * loads the object's attributes by giving a ticket_id, it will put the matching user_id and the ticket_id into the attributes.
+ * @param $ticket_id the id of the ticket that should be loaded
+ */
+ public function load($ticket_id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM `assigned` WHERE `Ticket` = :ticket_id", Array('ticket_id' => $ticket_id));
+ $row = $statement->fetch();
+ $this->set($row);
+ }
+
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get user attribute of the object.
+ */
+ public function getUser(){
+ return $this->user;
+ }
+
+
+ /**
+ * get ticket attribute of the object.
+ */
+ public function getTicket(){
+ return $this->ticket;
+ }
+
+ ////////////////////////////////////////////Setters////////////////////////////////////////////////////
+
+ /**
+ * set user attribute of the object.
+ * @param $u integer id of the user
+ */
+ public function setUser($u){
+ $this->user = $u;
+ }
+
+ /**
+ * set ticket attribute of the object.
+ * @param $t integer id of the ticket
+ */
+ public function setTicket($t){
+ $this->ticket = $t;
+ }
+
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/dblayer.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/dblayer.php
new file mode 100644
index 000000000..af826d084
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/dblayer.php
@@ -0,0 +1,71 @@
+ PDO::ERRMODE_EXCEPTION,
+ PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
+ );
+ $this->PDO = new PDO($dsn,$cfg['db'][$db]['user'],$cfg['db'][$db]['pass'], $opt);
+
+ }
+
+ /**
+ * execute a query that doesn't have any parameters
+ * @param $query the mysql query
+ * @return returns a PDOStatement object
+ */
+ public function executeWithoutParams($query){
+ $statement = $this->PDO->prepare($query);
+ $statement->execute();
+ return $statement;
+ }
+
+ /**
+ * execute a query that has parameters
+ * @param $query the mysql query
+ * @param $params the parameters that are being used by the query
+ * @return returns a PDOStatement object
+ */
+ public function execute($query,$params){
+ $statement = $this->PDO->prepare($query);
+ $statement->execute($params);
+ return $statement;
+ }
+
+ /**
+ * execute a query (an insertion query) that has parameters and return the id of it's insertion
+ * @param $query the mysql query
+ * @param $params the parameters that are being used by the query
+ * @return returns the id of the last inserted element.
+ */
+ public function executeReturnId($query,$params){
+ $statement = $this->PDO->prepare($query);
+ $this->PDO->beginTransaction();
+ $statement->execute($params);
+ $lastId =$this->PDO->lastInsertId();
+ $this->PDO->commit();
+ return $lastId;
+ }
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/forwarded.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/forwarded.php
new file mode 100644
index 000000000..54fece58c
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/forwarded.php
@@ -0,0 +1,159 @@
+load($ticket_id);
+ $forw->delete();
+ }
+ $forward = new Forwarded();
+ $forward->set(array('Group' => $group_id, 'Ticket' => $ticket_id));
+ $forward->create();
+ return "SUCCESS_FORWARDED";
+
+ }
+
+
+ /**
+ * get the id of the group a ticket is forwarded to.
+ * @param $ticket_id the id of the ticket.
+ * @return the id of the group
+ */
+ public static function getSGroupOfTicket($ticket_id) {
+ $forw = new self();
+ $forw->load($ticket_id);
+ return $forw->getGroup();
+ }
+
+
+ /**
+ * check if the ticket is forwarded
+ * @param $ticket_id the id of the ticket.
+ * @return returns true if the ticket is forwarded, else return false;
+ */
+ public static function isForwarded( $ticket_id) {
+ $dbl = new DBLayer("lib");
+ if( $dbl->execute(" SELECT * FROM `forwarded` WHERE `Ticket` = :ticket_id", array('ticket_id' => $ticket_id))->rowCount()){
+ return true;
+ }else{
+ return false;
+ }
+
+ }
+
+ ////////////////////////////////////////////Methods////////////////////////////////////////////////////
+
+
+ /**
+ * A constructor.
+ * Empty constructor
+ */
+ public function __construct() {
+ }
+
+
+ /**
+ * sets the object's attributes.
+ * @param $values should be an array of the form array('Group' => group_id, 'Ticket' => ticket_id).
+ */
+ public function set($values) {
+ $this->setGroup($values['Group']);
+ $this->setTicket($values['Ticket']);
+ }
+
+
+ /**
+ * creates a new 'forwarded' entry.
+ * this method will use the object's attributes for creating a new 'forwarded' entry in the database.
+ */
+ public function create() {
+ $dbl = new DBLayer("lib");
+ $query = "INSERT INTO `forwarded` (`Group`,`Ticket`) VALUES (:group, :ticket)";
+ $values = Array('group' => $this->getGroup(), 'ticket' => $this->getTicket());
+ $dbl->execute($query, $values);
+ }
+
+
+ /**
+ * deletes an existing 'forwarded' entry.
+ * this method will use the object's attributes for deleting an existing 'forwarded' entry in the database.
+ */
+ public function delete() {
+ $dbl = new DBLayer("lib");
+ $query = "DELETE FROM `forwarded` WHERE `Group` = :group_id and `Ticket` = :ticket_id";
+ $values = array('group_id' => $this->getGroup() ,'ticket_id' => $this->getTicket());
+ $dbl->execute($query, $values);
+ }
+
+
+ /**
+ * loads the object's attributes.
+ * loads the object's attributes by giving a ticket_id, it will put the matching group_id and the ticket_id into the attributes.
+ * @param $ticket_id the id of the ticket that should be loaded
+ */
+ public function load( $ticket_id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM `forwarded` WHERE `Ticket` = :ticket_id", Array('ticket_id' => $ticket_id));
+ $row = $statement->fetch();
+ $this->set($row);
+ }
+
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get group attribute of the object.
+ */
+ public function getGroup(){
+ return $this->group;
+ }
+
+ /**
+ * get ticket attribute of the object.
+ */
+ public function getTicket(){
+ return $this->ticket;
+ }
+
+ ////////////////////////////////////////////Setters////////////////////////////////////////////////////
+
+ /**
+ * set group attribute of the object.
+ * @param $g integer id of the group
+ */
+ public function setGroup($g){
+ $this->group = $g;
+ }
+
+ /**
+ * set ticket attribute of the object.
+ * @param $t integer id of the ticket
+ */
+ public function setTicket($t){
+ $this->ticket = $t;
+ }
+
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/gui_elements.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/gui_elements.php
new file mode 100644
index 000000000..e09de1621
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/gui_elements.php
@@ -0,0 +1,107 @@
+', $function);
+ $intermediate_result = NULL;
+ foreach($fnames as $fname) {
+ if(substr($fname, -2) == "()") {
+ $fname = substr($fname, 0, strlen($fname)-2);
+ if($intermediate_result == NULL) {
+ $intermediate_result = $element->$fname();
+ } else {
+ $intermediate_result = $intermediate_result->$fname();
+ }
+ } else {
+ if($intermediate_result == NULL) {
+ $intermediate_result = $element->$fname();
+ } else {
+ $intermediate_result = $intermediate_result->$fname();
+ }
+ }
+ }
+ $result[$i][$fieldArray[$j]] = $intermediate_result;
+ $j++;
+ }
+ $i++;
+ }
+ }
+ return $result;
+ }
+
+ /**
+ * creates an array of information out of a list of objects which can be used to form a table with a key as id.
+ * The idea is comparable to the make_table() function, though this time the results are stored in the index that is returned by the idFunction()
+ * @param $inputList the list of objects of which we want to make a table.
+ * @param $funcArray a list of methods of that object we want to perform.
+ * @param $idFunction a function that returns an id that will be used as index to store our result
+ * @return an array which holds the results of the methods in $funcArray on each object in the $inputList, though thearrays indexes are formed by using the idFunction.
+ */
+ public static function make_table_with_key_is_id( $inputList, $funcArray, $idFunction){
+ $result = Array();
+ foreach($inputList as $element){
+ foreach($funcArray as $function){
+ $result[$element->$idFunction()] = $element->$function();
+ }
+ }
+ return $result;
+ }
+
+
+ /**
+ * returns the elapsed time from a timestamp up till now.
+ * @param $ptime a timestamp.
+ * @return a string in the form of A years, B months, C days, D hours, E minutes, F seconds ago.
+ */
+ public static function time_elapsed_string($ptime){
+ global $TIME_FORMAT;
+ $ptime = DateTime::createFromFormat($TIME_FORMAT, $ptime)->getTimestamp();
+
+ $etime = time() - $ptime;
+
+ if ($etime < 1)
+ {
+ return '0 seconds';
+ }
+
+ $a = array( 12 * 30 * 24 * 60 * 60 => 'year',
+ 30 * 24 * 60 * 60 => 'month',
+ 24 * 60 * 60 => 'day',
+ 60 * 60 => 'hour',
+ 60 => 'minute',
+ 1 => 'second'
+ );
+
+ foreach ($a as $secs => $str)
+ {
+ $d = $etime / $secs;
+ if ($d >= 1)
+ {
+ $r = round($d);
+ return $r . ' ' . $str . ($r > 1 ? 's' : '') . ' ago';
+ }
+ }
+ }
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/helpers.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/helpers.php
new file mode 100644
index 000000000..9f8d61cbc
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/helpers.php
@@ -0,0 +1,224 @@
+setCompileDir($SITEBASE.'/templates_c/');
+ $smarty->setCacheDir($SITEBASE.'/cache/');
+ $smarty -> setConfigDir($SITEBASE . '/configs/' );
+ // turn smarty debugging on/off
+ $smarty -> debugging = false;
+ // caching must be disabled for multi-language support
+ $smarty -> caching = false;
+ $smarty -> cache_lifetime = 120;
+
+ //needed by smarty.
+ helpers :: create_folders ();
+ global $FORCE_INGAME;
+
+ //if ingame, then use the ingame templates
+ if ( helpers::check_if_game_client() or $FORCE_INGAME ){
+ $smarty -> template_dir = $AMS_LIB . '/ingame_templates/';
+ $smarty -> setConfigDir( $AMS_LIB . '/configs' );
+ $variables = parse_ini_file( $AMS_LIB . '/configs/ingame_layout.ini', true );
+ foreach ( $variables[$INGAME_LAYOUT] as $key => $value ){
+ $smarty -> assign( $key, $value );
+ }
+ }else{
+ $smarty -> template_dir = $SITEBASE . '/templates/';
+ $smarty -> setConfigDir( $SITEBASE . '/configs' );
+ }
+
+ foreach ( $vars as $key => $value ){
+ $smarty -> assign( $key, $value );
+ }
+
+ //load page specific variables that are language dependent
+ $variables = Helpers::handle_language();
+ foreach ( $variables[$template] as $key => $value ){
+ $smarty -> assign( $key, $value );
+ }
+
+ //smarty inheritance for loading the matching wrapper layout (with the matching menu bar)
+ if( isset($vars['permission']) && $vars['permission'] == 3 ){
+ $inherited = "extends:layout_admin.tpl|";
+ }else if( isset($vars['permission']) && $vars['permission'] == 2){
+ $inherited = "extends:layout_mod.tpl|";
+ }else if( isset($vars['permission']) && $vars['permission'] == 1){
+ $inherited = "extends:layout_user.tpl|";
+ }else{
+ $inherited ="";
+ }
+
+ //if $returnHTML is set to true, return the html by fetching the template else display the template.
+ if($returnHTML == true){
+ return $smarty ->fetch($inherited . $template . '.tpl' );
+ }else{
+ $smarty -> display( $inherited . $template . '.tpl' );
+ }
+ }
+
+
+ /**
+ * creates the folders that are needed for smarty.
+ * @todo for the drupal module it might be possible that drupal_mkdir needs to be used instead of mkdir, also this should be in the install.php instead.
+ */
+ static public function create_folders(){
+ global $AMS_LIB;
+ global $SITEBASE;
+ $arr = array( $AMS_LIB . '/ingame_templates/',
+ $AMS_LIB . '/configs',
+ //$AMS_LIB . '/cache',
+ $SITEBASE . '/cache/',
+ $SITEBASE . '/templates/',
+ $SITEBASE . '/templates_c/',
+ $SITEBASE . '/configs'
+ );
+ foreach ( $arr as & $value ){
+
+ if ( !file_exists( $value ) ){
+ print($value);
+ mkdir($value);
+ }
+ }
+
+ }
+
+
+ /**
+ * check if the http request is sent ingame or not.
+ * @return returns true in case it's sent ingame, else false is returned.
+ */
+ static public function check_if_game_client()
+ {
+ // if HTTP_USER_AGENT is not set then its ryzom core
+ global $FORCE_INGAME;
+ if ( ( isset($_SERVER['HTTP_USER_AGENT']) && (strpos($_SERVER['HTTP_USER_AGENT'],"Ryzom") === 0)) || $FORCE_INGAME || ! isset($_SERVER['HTTP_USER_AGENT']) ){
+ return true;
+ }else{
+ return false;
+ }
+ }
+
+
+ /**
+ * Handles the language specific aspect.
+ * The language can be changed by setting the $_GET['Language'] & $_GET['setLang'] together. This will also change the language entry of the user in the db.
+ * Cookies are also being used in case the user isn't logged in.
+ * @return returns the parsed content of the language .ini file related to the users language setting.
+ */
+ static public function handle_language(){
+ global $DEFAULT_LANGUAGE;
+ global $AMS_TRANS;
+
+ //if user wants to change the language
+ if(isset($_GET['Language']) && isset($_GET['setLang'])){
+ //The ingame client sometimes sends full words, derive those!
+ switch($_GET['Language']){
+
+ case "English":
+ $lang = "en";
+ break;
+
+ case "French":
+ $lang = "fr";
+ break;
+
+ default:
+ $lang = $_GET['Language'];
+ }
+ //if the file exists en the setLang = true
+ if( file_exists( $AMS_TRANS . '/' . $lang . '.ini' ) && $_GET['setLang'] == "true"){
+ //set a cookie & session var and incase logged in write it to the db!
+ setcookie( 'Language', $lang , time() + 60*60*24*30 );
+ $_SESSION['Language'] = $lang;
+ if(WebUsers::isLoggedIn()){
+ WebUsers::setLanguage($_SESSION['id'],$lang);
+ }
+ }else{
+ $_SESSION['Language'] = $DEFAULT_LANGUAGE;
+ }
+ }else{
+ //if the session var is not set yet
+ if(!isset($_SESSION['Language'])){
+ //check if a cookie already exists for it
+ if ( isset( $_COOKIE['Language'] ) ) {
+ $_SESSION['Language'] = $_COOKIE['Language'];
+ //else use the default language
+ }else{
+ $_SESSION['Language'] = $DEFAULT_LANGUAGE;
+ }
+ }
+ }
+
+ if ($_SESSION['Language'] == ""){
+ $_SESSION['Language'] = $DEFAULT_LANGUAGE;
+ }
+ return parse_ini_file( $AMS_TRANS . '/' . $_SESSION['Language'] . '.ini', true );
+
+ }
+
+
+ /**
+ * Time output function for handling the time display.
+ * @return returns the time in the format specified in the $TIME_FORMAT global variable.
+ */
+ static public function outputTime($time, $str = 1){
+ global $TIME_FORMAT;
+ if($str){
+ return date($TIME_FORMAT,strtotime($time));
+ }else{
+ return date($TIME_FORMAT,$time);
+ }
+ }
+
+ /**
+ * Auto login function for ingame use.
+ * This function will allow users who access the website ingame, to log in without entering the username and password. It uses the COOKIE entry in the open_ring db.
+ * it checks if the cookie sent by the http request matches the one in the db. This cookie in the db is changed everytime the user relogs.
+ * @return returns "FALSE" if the cookies didn't match, else it returns an array with the user's id and name.
+ */
+ static public function check_login_ingame(){
+ if ( helpers :: check_if_game_client () or $forcelibrender = false ){
+ $dbr = new DBLayer("ring");
+ if (isset($_GET['UserId']) && isset($_COOKIE['ryzomId'])){
+ $id = $_GET['UserId'];
+ $statement = $dbr->execute("SELECT * FROM ring_users WHERE user_id=:id AND cookie =:cookie", array('id' => $id, 'cookie' => $_COOKIE['ryzomId']));
+ if ($statement->rowCount() ){
+ $entry = $statement->fetch();
+ //print_r($entry);
+ return array('id' => $entry['user_id'], 'name' => $entry['user_name']);
+ }else{
+ return "FALSE";
+ }
+ }else{
+ return "FALSE";
+ }
+ }else{
+ return "FALSE";
+ }
+ }
+}
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/in_support_group.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/in_support_group.php
new file mode 100644
index 000000000..bf10d3d9a
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/in_support_group.php
@@ -0,0 +1,121 @@
+execute(" SELECT * FROM `in_support_group` WHERE `User` = :user_id and `Group` = :group_id ", array('user_id' => $user_id, 'group_id' => $group_id) )->rowCount() ){
+ return true;
+ }else{
+ return false;
+ }
+ }
+
+ ////////////////////////////////////////////Methods////////////////////////////////////////////////////
+
+ /**
+ * A constructor.
+ * Empty constructor
+ */
+ public function __construct() {
+ }
+
+
+ /**
+ * sets the object's attributes.
+ * @param $values should be an array of the form array('User' => user_id, 'Group' => support_groups_id).
+ */
+ public function set($values) {
+ $this->setUser($values['User']);
+ $this->setGroup($values['Group']);
+ }
+
+
+ /**
+ * creates a new 'in_support_group' entry.
+ * this method will use the object's attributes for creating a new 'in_support_group' entry in the database.
+ */
+ public function create() {
+ $dbl = new DBLayer("lib");
+ $query = "INSERT INTO `in_support_group` (`User`,`Group`) VALUES (:user, :group)";
+ $values = Array('user' => $this->user, 'group' => $this->group);
+ $dbl->execute($query, $values);
+ }
+
+
+ /**
+ * deletes an existing 'in_support_group' entry.
+ * this method will use the object's attributes for deleting an existing 'in_support_group' entry in the database.
+ */
+ public function delete() {
+ $dbl = new DBLayer("lib");
+ $query = "DELETE FROM `in_support_group` WHERE `User` = :user_id and `Group` = :group_id";
+ $values = array('user_id' => $this->getUser() ,'group_id' => $this->getGroup());
+ $dbl->execute($query, $values);
+ }
+
+ /*
+ public function load($group_id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM `in_support_group` WHERE `Group` = :group_id", Array('group_id' => $group_id));
+ $row = $statement->fetch();
+ $this->set($row);
+ }
+ */
+
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get user attribute of the object.
+ */
+ public function getUser(){
+ return $this->user;
+ }
+
+
+ /**
+ * get group attribute of the object.
+ */
+ public function getGroup(){
+ return $this->group;
+ }
+
+ ////////////////////////////////////////////Setters////////////////////////////////////////////////////
+
+ /**
+ * set user attribute of the object.
+ * @param $u integer id of the user
+ */
+ public function setUser($u){
+ $this->user = $u;
+ }
+
+
+ /**
+ * set group attribute of the object.
+ * @param $g integer id of the support group
+ */
+ public function setGroup($g){
+ $this->group = $g;
+ }
+
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/mail_handler.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/mail_handler.php
new file mode 100644
index 000000000..dde8d4e02
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/mail_handler.php
@@ -0,0 +1,483 @@
+ getLanguage();
+ }else{
+ global $DEFAULT_LANGUAGE;
+ $lang = $DEFAULT_LANGUAGE;
+ }
+ $variables = parse_ini_file( $AMS_TRANS . '/' . $lang . '.ini', true );
+ $mailText = array();
+ foreach ( $variables['email'] as $key => $value ){
+ $mailText[$key] = $value;
+ }
+
+ switch($type){
+ case "REPLY":
+ $webUser = new WebUsers($receiver);
+ if($webUser->getReceiveMail()){
+ $subject = $mailText['email_subject_new_reply'] . $ticketObj->getTId() ."]";
+ $txt = $mailText['email_body_new_reply_1']. $ticketObj->getTId() . $mailText['email_body_new_reply_2'] . $ticketObj->getTitle() .
+ $mailText['email_body_new_reply_3'] . $content . $mailText['email_body_new_reply_4'];
+ self::send_mail($receiver,$subject,$txt, $ticketObj->getTId(),$sender);
+ }
+ break;
+
+ case "NEW":
+ $webUser = new WebUsers($receiver);
+ if($webUser->getReceiveMail()){
+ $subject = $mailText['email_subject_new_ticket'] . $ticketObj->getTId() ."]";
+ $txt = $mailText['email_body_new_ticket_1'] . $ticketObj->getTId() . $mailText['email_body_new_ticket_2'] . $ticketObj->getTitle() . $mailText['email_body_new_ticket_3']
+ . $content . $mailText['email_body_new_ticket_4'];
+ self::send_mail($receiver,$subject,$txt, $ticketObj->getTId(), $sender);
+ }
+ break;
+
+ case "WARNAUTHOR":
+ if(is_numeric($sender)){
+ $sender = Ticket_User::get_email_by_user_id($sender);
+ }
+ $subject = $mailText['email_subject_warn_author'] . $ticketObj->getTId() ."]";
+ $txt = $mailText['email_body_warn_author_1'] . $ticketObj->getTitle() .$mailText['email_body_warn_author_2'].$sender.$mailText['email_body_warn_author_3'].
+ $sender. $mailText['email_body_warn_author_4'] ;
+ self::send_mail($receiver,$subject,$txt, $ticketObj->getTId(), NULL);
+ break;
+
+ case "WARNSENDER":
+ $subject = $mailText['email_subject_warn_sender'];
+ $txt = $mailText['email_body_warn_sender'];
+ self::send_mail($receiver,$subject,$txt, $ticketObj->getTId(), NULL);
+ break;
+
+ case "WARNUNKNOWNSENDER":
+ $subject = $mailText['email_subject_warn_unknown_sender'];
+ $txt = $mailText['email_body_warn_unknown_sender'];
+ self::send_mail($receiver,$subject,$txt, $ticketObj->getTId(), NULL);
+ break;
+
+ }
+ }
+ }
+
+ /**
+ * send mail function that will add the email to the db.
+ * this function is being used by the send_ticketing_mail() function. It adds the email as an entry to the `email` table in the database, which will be sent later on when we run the cron job.
+ * @param $recipient if integer, then it refers to the id of the user to whom we want to mail, if it's a string(email-address) then we will use that.
+ * @param $subject the subject of the email
+ * @param $body the body of the email
+ * @param $ticket_id the id of the ticket
+ * @param $from the sending support_group's id (NULL in case the default group is sending))
+ */
+ public static function send_mail($recipient, $subject, $body, $ticket_id = 0, $from = NULL) {
+ $id_user = NULL;
+ if(is_numeric($recipient)) {
+ $id_user = $recipient;
+ $recipient = NULL;
+ }
+
+ $query = "INSERT INTO email (Recipient,Subject,Body,Status,Attempts,Sender,UserId,MessageId,TicketId) VALUES (:recipient, :subject, :body, :status, :attempts, :sender, :id_user, :messageId, :ticketId)";
+ $values = array('recipient' => $recipient, 'subject' => $subject, 'body' => $body, 'status' => 'NEW', 'attempts'=> 0, 'sender' => $from,'id_user' => $id_user, 'messageId' => 0, 'ticketId'=> $ticket_id);
+ $db = new DBLayer("lib");
+ $db->execute($query, $values);
+
+ }
+
+
+ /**
+ * the cron funtion (workhorse of the mailing system).
+ * The cron job will create a child process, which will first send the emails that are in the email table in the database, we use some kind of semaphore (a temp file) to make sure that
+ * if the cron job is called multiple times, it wont email those mails multiple times. After this, we will read the mail inboxes of the support groups and the default group using IMAP
+ * and we will add new tickets or new replies according to the incoming emails.
+ */
+ function cron() {
+ global $cfg;
+ global $MAIL_LOG_PATH;
+ $default_groupemail = $cfg['mail']['default_groupemail'];
+ $default_groupname = $cfg['mail']['default_groupname'];
+ /*
+ $inbox_host = $cfg['mail']['host'];
+ $oms_reply_to = "Ryzom Ticketing Support ";*/
+ global $MAIL_DIR;
+ error_log("========================================================\n", 3, $MAIL_LOG_PATH);
+ error_log("mailing cron Job started at: ". Helpers::outputTime(time(),0) . "\n", 3, $MAIL_LOG_PATH);
+
+ //creates child process
+ $pid = self::mail_fork();
+ $pidfile = '/tmp/ams_cron_email_pid';
+
+ if($pid) {
+
+ // We're the parent process, do nothing!
+ //INFO: if $pid =
+ //-1: "Could not fork!\n";
+ // 0: "In child!\n";
+ //>0: "In parent!\n";
+
+ } else {
+ //deliver new mail
+ //make db connection here because the children have to make the connection.
+ $this->db = new DBLayer("lib");
+
+ //if $pidfile doesn't exist yet, then start sending the mails that are in the db.
+ if(!file_exists($pidfile)) {
+
+ //create the file and write the child processes id in it!
+ $pid = getmypid();
+ $file = fopen($pidfile, 'w');
+ fwrite($file, $pid);
+ fclose($file);
+
+ //select all new & failed emails & try to send them
+ //$emails = db_query("select * from email where status = 'NEW' or status = 'FAILED'");
+ $statement = $this->db->executeWithoutParams("select * from email where Status = 'NEW' or Status = 'FAILED'");
+ $emails = $statement->fetchAll();
+
+ foreach($emails as $email) {
+ $message_id = self::new_message_id($email['TicketId']);
+
+ //if recipient isn't given, then use the email of the id_user instead!
+ if(!$email['Recipient']) {
+ $email['Recipient'] = Ticket_User::get_email_by_user_id($email['UserId']);
+ }
+
+ //create sending email adres based on the $sender id which refers to the department id
+ if($email['Sender'] == NULL) {
+ $from = $default_groupname ." <".$default_groupemail.">";
+ } else {
+ $group = Support_Group::getGroup($email['Sender']);
+ $from = $group->getName()." <".$group->getGroupEmail().">";
+ }
+
+ $headers = "From: $from\r\n" . "Message-ID: " . $message_id ;
+
+ if(mail($email['Recipient'], $email['Subject'], $email['Body'], $headers)) {
+ $status = "DELIVERED";
+ error_log("Emailed {$email['Recipient']}\n", 3, $MAIL_LOG_PATH);
+ } else {
+ $status = "FAILED";
+ error_log("Email to {$email['Recipient']} failed\n", 3, $MAIL_LOG_PATH);
+ }
+ //change the status of the emails.
+ $this->db->execute('update email set Status = ?, MessageId = ?, Attempts = Attempts + 1 where MailId = ?', array($status, $message_id, $email['MailId']));
+
+ }
+ unlink($pidfile);
+ }
+ // Check mail
+ $sGroups = Support_Group::getGroups();
+
+ //decrypt passwords in the db!
+ $crypter = new MyCrypt($cfg['crypt']);
+ foreach($sGroups as $group){
+ $group->setIMAP_Password($crypter->decrypt($group->getIMAP_Password()));
+ }
+
+ $defaultGroup = new Support_Group();
+ $defaultGroup->setSGroupId(0);
+ $defaultGroup->setGroupEmail($default_groupemail);
+ $defaultGroup->setIMAP_MailServer($cfg['mail']['default_mailserver']);
+ $defaultGroup->setIMAP_Username($cfg['mail']['default_username']);
+ $defaultGroup->setIMAP_Password($cfg['mail']['default_password']);
+
+ //add default group to the list
+ $sGroups[] = $defaultGroup;
+
+ foreach($sGroups as $group){
+ //check if group has mailing stuff filled in!
+ if($group->getGroupEmail() != "" && $group->getIMAP_MailServer() != "" && $group->getIMAP_Username() != "" && $group->getIMAP_Password() != ""){
+ $mbox = imap_open($group->getIMAP_MailServer(), $group->getIMAP_Username(), $group->getIMAP_Password()) or die('Cannot connect to mail server: ' . imap_last_error());
+ $message_count = imap_num_msg($mbox);
+
+ for ($i = 1; $i <= $message_count; ++$i) {
+
+ //return task ID
+ $tkey = self::incoming_mail_handler($mbox, $i,$group);
+
+ if($tkey) {
+ //base file on Ticket + timestamp
+ $file = fopen($MAIL_DIR."/ticket".$tkey, 'w');
+ error_log("Email was written to ".$MAIL_DIR."/ticket".$tkey."\n", 3, $MAIL_LOG_PATH);
+ fwrite($file, imap_fetchheader($mbox, $i) . imap_body($mbox, $i));
+ fclose($file);
+
+ //mark message $i of $mbox for deletion!
+ imap_delete($mbox, $i);
+ }
+
+ }
+ //delete marked messages
+ imap_expunge($mbox);
+ imap_close($mbox);
+ }
+ }
+ error_log("Child Cron job finished at ". Helpers::outputTime(time(),0) . "\n", 3, $MAIL_LOG_PATH);
+ error_log("========================================================\n", 3, $MAIL_LOG_PATH);
+ }
+
+
+ }
+
+
+
+ /**
+ * creates a new message id for a email about to send.
+ * @param $ticketId the ticket id of the ticket that is mentioned in the email.
+ * @return returns a string, that consist out of some variable parts, a consistent part and the ticket_id. The ticket_id will be used lateron, if someone replies on the message,
+ * to see to which ticket the reply should be added.
+ */
+ function new_message_id($ticketId) {
+ $time = time();
+ $pid = getmypid();
+ global $cfg;
+ global $ams_mail_count;
+ $ams_mail_count = ($ams_mail_count == '') ? 1 : $ams_mail_count + 1;
+ return "";
+
+ }
+
+ /**
+ * try to fetch the ticket_id out of the subject.
+ * The subject should have a substring of the form [Ticket \#ticket_id], where ticket_id should be the integer ID of the ticket.
+ * @param $subject the subject of an incomming email.
+ * @return if the ticket's id is succesfully parsed, it will return the ticket_id, else it returns 0.
+ */
+ function get_ticket_id_from_subject($subject){
+ $startpos = strpos($subject, "[Ticket #");
+ if($startpos){
+ $tempString = substr($subject, $startpos+9);
+ $endpos = strpos($tempString, "]");
+ if($endpos){
+ $ticket_id = substr($tempString, 0, $endpos);
+ }else{
+ $ticket_id = 0;
+ }
+ }else{
+ $ticket_id = 0;
+ }
+ return $ticket_id;
+ }
+
+
+ /**
+ * Handles an incomming email
+ * Read the content of one email by using imap's functionality. If a ticket id is found inside the message_id or else in the subject line, then a reply will be added
+ * (if the email is not being sent from the authors email address it won't be added though and a warning will be sent to both parties). If no ticket id is found, then a new
+ * ticket will be created.
+ * @param $mbox a mailbox object
+ * @param $i the email's id in the mailbox (integer)
+ * @param $group the group object that owns the inbox.
+ * @return a string based on the found ticket i and timestamp (will be used to store a copy of the email locally)
+ */
+ function incoming_mail_handler($mbox,$i,$group){
+
+ global $MAIL_LOG_PATH;
+
+ $header = imap_header($mbox, $i);
+ $subject = self::decode_utf8($header->subject);
+ $entire_email = imap_fetchheader($mbox, $i) . imap_body($mbox, $i);
+ $subject = self::decode_utf8($header->subject);
+ $to = $header->to[0]->mailbox;
+ $from = $header->from[0]->mailbox . '@' . $header->from[0]->host;
+ $fromEmail = $header->from[0]->mailbox . '@' . $header->from[0]->host;
+ $txt = self::get_part($mbox, $i, "TEXT/PLAIN");
+ //$html = self::get_part($mbox, $i, "TEXT/HTML");
+
+ //get the id out of the email address of the person sending the email.
+ if($from !== NULL && !is_numeric($from)){
+ $from = Ticket_User::get_id_from_email($from);
+ }
+
+ //get ticket_id out of the message-id or else out of the subject line
+ $ticket_id = 0;
+ if(isset($header->references)){
+ $pieces = explode(".", $header->references);
+ if($pieces[0] == " 0){
+ $ticket = new Ticket();
+ $ticket->load_With_TId($ticket_id);
+
+ //if email is sent from an existing email address in the db (else it will give an error while loading the user object)
+ if($from != "FALSE"){
+
+ $user = new Ticket_User();
+ $user->load_With_TUserId($from);
+
+ //if user has access to it!
+ if((Ticket_User::isMod($user) or ($ticket->getAuthor() == $user->getTUserId())) and $txt != ""){
+
+ Ticket::createReply($txt, $user->getTUserId(), $ticket->getTId(), 0);
+ error_log("Email found that is a reply to a ticket at:".$group->getGroupEmail()."\n", 3, $MAIL_LOG_PATH);
+
+ }else{
+ //if user has no access to it
+ //Warn real ticket owner + person that send the mail
+ Mail_Handler::send_ticketing_mail($ticket->getAuthor(),$ticket, NULL , "WARNAUTHOR" , $from);
+ Mail_Handler::send_ticketing_mail($from ,$ticket, NULL , "WARNSENDER" , NULL);
+
+ error_log("Email found that was a reply to a ticket, though send by another user to ".$group->getGroupEmail()."\n", 3, $MAIL_LOG_PATH);
+
+ }
+
+ }else{
+
+ //if a reply to a ticket is being sent by a non-user!
+ //Warn real ticket owner + person that send the mail
+ Mail_Handler::send_ticketing_mail($ticket->getAuthor() ,$ticket, NULL , "WARNAUTHOR" , $fromEmail);
+ Mail_Handler::send_ticketing_mail($fromEmail ,$ticket, NULL , "WARNUNKNOWNSENDER" , NULL);
+
+ error_log("Email found that was a reply to a ticket, though send by an unknown email address to ".$group->getGroupEmail()."\n", 3, $MAIL_LOG_PATH);
+
+ }
+
+ return $ticket_id .".".time();
+
+ }else if($from != "FALSE"){
+
+ //if ticket_id isn't found, create a new ticket!
+ //if an existing email address mailed the ticket
+
+ //if not default group, then forward it by giving the $group->getSGroupId's param
+ $newTicketId = Ticket::create_Ticket($subject, $txt,1, $from, $from, $group->getSGroupId());
+
+ error_log("Email regarding new ticket found at:".$group->getGroupEmail()."\n", 3, $MAIL_LOG_PATH);
+
+ return $newTicketId .".".time();
+
+
+ }else{
+ //if it's a email that has nothing to do with ticketing, return 0;
+ error_log("Email found that isn't a reply or new ticket, at:".$group->getGroupEmail()."\n", 3, $MAIL_LOG_PATH);
+ return 0;
+ }
+
+ }
+
+
+ /**
+ * decode utf8
+ * @param $str str to be decoded
+ * @return decoded string
+ */
+ function decode_utf8($str) {
+
+ preg_match_all("/=\?UTF-8\?B\?([^\?]+)\?=/i",$str, $arr);
+ for ($i=0;$isubtype) {
+ return $primary_mime_type[(int) $structure->type] . '/' .$structure->subtype;
+ }
+ return "TEXT/PLAIN";
+
+ }
+
+
+ //to document..
+ function get_part($stream, $msg_number, $mime_type, $structure = false, $part_number = false) {
+
+ if(!$structure) {
+ $structure = imap_fetchstructure($stream, $msg_number);
+ }
+
+ if($structure) {
+ if($mime_type == self::get_mime_type($structure)) {
+ if(!$part_number) {
+ $part_number = "1";
+ }
+ $text = imap_fetchbody($stream, $msg_number, $part_number);
+ if($structure->encoding == 3) {
+ return imap_base64($text);
+ } else if($structure->encoding == 4) {
+ return imap_qprint($text);
+ } else {
+ return $text;
+ }
+ }
+
+ if($structure->type == 1) /* multipart */ {
+ while(list($index, $sub_structure) = each($structure->parts)) {
+ if($part_number) {
+ $prefix = $part_number . '.';
+ } else {
+ $prefix = '';
+ }
+ $data = self::get_part($stream, $msg_number, $mime_type, $sub_structure,$prefix . ($index + 1));
+ if($data) {
+ return $data;
+ }
+ } // END OF WHILE
+ } // END OF MULTIPART
+ } // END OF STRUTURE
+ return false;
+
+ } // END OF FUNCTION
+
+}
+
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/mycrypt.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/mycrypt.php
new file mode 100644
index 000000000..6c027e52a
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/mycrypt.php
@@ -0,0 +1,85 @@
+config = $cryptinfo;
+ }
+
+ /**
+ * encrypts by using the given enc_method and hash_method.
+ * It will first check if the methods are supported, if not it will throw an error, if so it will encrypt the $data
+ * @param $data the string that we want to encrypt.
+ * @return the encrypted string.
+ */
+ public function encrypt($data) {
+
+ self::check_methods($this->config['enc_method'], $this->config['hash_method']);
+ $iv = self::hashIV($this->config['key'], $this->config['hash_method'], openssl_cipher_iv_length($this->config['enc_method']));
+ $infostr = sprintf('$%s$%s$', $this->config['enc_method'], $this->config['hash_method']);
+ return $infostr . openssl_encrypt($data, $this->config['enc_method'], $this->config['key'], false, $iv);
+ }
+
+ /**
+ * decrypts by using the given enc_method and hash_method.
+ * @param $edata the encrypted string that we want to decrypt
+ * @return the decrypted string.
+ */
+ public function decrypt($edata) {
+ $e_arr = explode('$', $edata);
+ if( count($e_arr) != 4 ) {
+ Throw new Exception('Given data is missing crucial sections.');
+ }
+ $this->config['enc_method'] = $e_arr[1];
+ $this->config['hash_method'] = $e_arr[2];
+ self::check_methods($this->config['enc_method'], $this->config['hash_method']);
+ $iv = self::hashIV($this->config['key'], $this->config['hash_method'], openssl_cipher_iv_length($this->config['enc_method']));
+ return openssl_decrypt($e_arr[3], $this->config['enc_method'], $this->config['key'], false, $iv);
+ }
+
+ /**
+ * hashes the key by using a hash method specified.
+ * @param $key the key to be hashed
+ * @param $method the metho of hashing to be used
+ * @param $iv_size the size of the initialization vector.
+ * @return return the hashed key up till the size of the iv_size param.
+ */
+ private static function hashIV($key, $method, $iv_size) {
+ $myhash = hash($method, $key, TRUE);
+ while( strlen($myhash) < $iv_size ) {
+ $myhash .= hash($method, $myhash, TRUE);
+ }
+ return substr($myhash, 0, $iv_size);
+ }
+
+ /**
+ * checks if the encryption and hash methods are supported
+ * @param $enc the encryption method.
+ * @param $hash the hash method.
+ * @throw Exception in case a method is not supported.
+ */
+ private static function check_methods($enc, $hash) {
+
+ if( ! function_exists('openssl_encrypt') ) {
+ Throw new Exception('openssl_encrypt() not supported.');
+ } else if( ! in_array($enc, openssl_get_cipher_methods()) ) {
+ Throw new Exception('Encryption method ' . $enc . ' not supported.');
+ } else if( ! in_array(strtolower($hash), hash_algos()) ) {
+ Throw new Exception('Hashing method ' . $hash . ' not supported.');
+ }
+ }
+
+
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/pagination.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/pagination.php
new file mode 100644
index 000000000..182d9f5af
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/pagination.php
@@ -0,0 +1,138 @@
+current= 1;
+ }else{
+ $this->current= $_GET['pagenum'];
+ }
+
+ //Here we count the number of results
+ $db = new DBLayer($db);
+ $rows = $db->execute($query, $params)->rowCount();
+ $this->amountOfRows = $rows;
+ //the array hat will contain all users
+
+ if($rows > 0){
+ //This is the number of results displayed per page
+ $page_rows = $nrDisplayed;
+
+ //This tells us the page number of our last page
+ $this->last = ceil($rows/$page_rows);
+
+ //this makes sure the page number isn't below one, or more than our maximum pages
+ if ($this->current< 1)
+ {
+ $this->current= 1;
+ }else if ($this->current> $this->last) {
+ $this->current= $this->last;
+ }
+
+ //This sets the range to display in our query
+ $max = 'limit ' .($this->current- 1) * $page_rows .',' .$page_rows;
+
+ //This is your query again, the same one... the only difference is we add $max into it
+ $data = $db->execute($query . " " . $max, $params);
+
+ $this->element_array = Array();
+ //This is where we put the results in a resultArray to be sent to smarty
+ while($row = $data->fetch(PDO::FETCH_ASSOC)){
+ $element = new $resultClass();
+ $element->set($row);
+ $this->element_array[] = $element;
+ }
+ }
+ }
+
+
+ /**
+ * return the number of the 'last' object attribute
+ * @return the number of the last page
+ */
+ public function getLast(){
+ return $this->last;
+ }
+
+
+ /**
+ * return the number of the 'current' object attribute
+ * @return the number of the current page
+ */
+ public function getCurrent(){
+ return $this->current;
+ }
+
+
+ /**
+ * return the elements array of the object
+ * @return the elements of a specific page (these are instantiations of the class passed as parameter ($resultClass) to the constructor)
+ */
+ public function getElements(){
+ return $this->element_array;
+ }
+
+
+ /**
+ * return total amount of rows for the original query
+ * @return the total amount of rows for the original query
+ */
+ public function getAmountOfRows(){
+ return $this->amountOfRows;
+ }
+
+ /**
+ * return the page links.
+ * (for browsing the pages, placed under a table for example) the $nrOfLinks parameter specifies the amount of links you want to return.
+ * it will show the links closest to the current page on both sides (in case one side can't show more, it will show more on the other side)
+ * @return an array of integerswhich refer to the clickable pagenumbers for browsing other pages.
+ */
+ public function getLinks($nrOfLinks){
+ $pageLinks = Array();
+ //if amount of showable links is greater than the amount of pages: show all!
+ if ($this->last <= $nrOfLinks){
+ for($var = 1; $var <= $this->last; $var++){
+ $pageLinks[] = $var;
+ }
+ }else{
+ $offset = ($nrOfLinks-1)/2 ;
+ $startpoint = $this->current - $offset;
+ $endpoint = $this->current + $offset;
+
+ if($startpoint < 1){
+ $startpoint = 1;
+ $endpoint = $startpoint + $nrOfLinks - 1;
+ }else if($endpoint > $this->last){
+ $endpoint = $this->last;
+ $startpoint = $endpoint - ($nrOfLinks -1);
+ }
+
+ for($var = $startpoint; $var <= $endpoint; $var++){
+ $pageLinks[] = $var;
+ }
+ }
+ return $pageLinks;
+ }
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/querycache.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/querycache.php
new file mode 100644
index 000000000..3da0887c9
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/querycache.php
@@ -0,0 +1,130 @@
+ sid, 'type' => type, 'query' => query, 'db' => db).
+ */
+ public function set($values) {
+ $this->setSID($values['SID']);
+ $this->setType($values['type']);
+ $this->setQuery($values['query']);
+ $this->setDb($values['db']);
+ }
+
+
+ /**
+ * loads the object's attributes.
+ * loads the object's attributes by giving a SID as parameter
+ * @param $id the id of the querycaches row
+ */
+ public function load_With_SID( $id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ams_querycache WHERE SID=:id", array('id' => $id));
+ $row = $statement->fetch();
+ $this->set($row);
+ }
+
+
+ /**
+ * updates the entry.
+ */
+ public function update(){
+ $dbl = new DBLayer("lib");
+ $query = "UPDATE ams_querycache SET type= :t, query = :q, db = :d WHERE SID=:id";
+ $values = Array('id' => $this->getSID(), 't' => $this->getType(), 'q' => $this->getQuery(), 'd' => $this->getDb());
+ $statement = $dbl->execute($query, $values);
+ }
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get SID attribute of the object.
+ */
+ public function getSID(){
+ return $this->SID;
+ }
+
+ /**
+ * get type attribute of the object.
+ */
+ public function getType(){
+ return $this->type;
+ }
+
+ /**
+ * get query attribute of the object.
+ */
+ public function getQuery(){
+ return $this->query;
+ }
+
+ /**
+ * get db attribute of the object.
+ */
+ public function getDb(){
+ return $this->db;
+ }
+
+ ////////////////////////////////////////////Setters////////////////////////////////////////////////////
+
+ /**
+ * set SID attribute of the object.
+ * @param $s integer id
+ */
+ public function setSID($s){
+ $this->SID = $s;
+ }
+
+ /**
+ * set type attribute of the object.
+ * @param $t type of the query, could be changePassword, changePermissions, changeEmail, createUser
+ */
+ public function setType($t){
+ $this->type = $t;
+ }
+
+ /**
+ * set query attribute of the object.
+ * @param $q query string
+ */
+ public function setQuery($q){
+ $this->query= $q;
+ }
+
+ /**
+ * set db attribute of the object.
+ * @param $d the name of the database in the config global var that we want to use.
+ */
+ public function setDb($d){
+ $this->db= $d;
+ }
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/support_group.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/support_group.php
new file mode 100644
index 000000000..005f775c1
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/support_group.php
@@ -0,0 +1,453 @@
+execute("SELECT * FROM support_group WHERE SGroupId = :id", array('id' => $id));
+ $row = $statement->fetch();
+ $instanceGroup = new self();
+ $instanceGroup->set($row);
+ return $instanceGroup;
+
+ }
+
+
+ /**
+ * return all support_group objects.
+ * @return an array containing all support_group objects.
+ */
+ public static function getGroups() {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->executeWithoutParams("SELECT * FROM support_group ORDER BY Name ASC");
+ $rows = $statement->fetchAll();
+ $result = Array();
+ foreach($rows as $group){
+
+ $instanceGroup = new self();
+ $instanceGroup->set($group);
+ $result[] = $instanceGroup;
+ }
+ return $result;
+ }
+
+
+ /**
+ * Wrapper for creating a support group.
+ * It will check if the support group doesn't exist yet, if the tag or name already exists then NAME_TAKEN or TAG_TAKEN will be returned.
+ * If the name is bigger than 20 characters or smaller than 4 and the tag greater than 7 or smaller than 2 a SIZE_ERROR will be returned.
+ * Else it will return SUCCESS
+ * @return a string that specifies if it was a success or not (SUCCESS, SIZE_ERROR, NAME_TAKEN or TAG_TAKEN )
+ */
+ public static function createSupportGroup( $name, $tag, $groupemail, $imap_mailserver, $imap_username, $imap_password) {
+
+ if(strlen($name) < 21 && strlen($name) > 4 &&strlen($tag) < 8 && strlen($tag) > 1 ){
+ $notExists = self::supportGroup_EntryNotExists($name, $tag);
+ if ( $notExists == "SUCCESS" ){
+ $sGroup = new self();
+ $values = array('Name' => $name, 'Tag' => $tag, 'GroupEmail' => $groupemail, 'IMAP_MailServer' => $imap_mailserver, 'IMAP_Username' => $imap_username, 'IMAP_Password' => $imap_password);
+ $sGroup->setName($values['Name']);
+ $sGroup->setTag($values['Tag']);
+ $sGroup->setGroupEmail($values['GroupEmail']);
+ $sGroup->setIMAP_MailServer($values['IMAP_MailServer']);
+ $sGroup->setIMAP_Username($values['IMAP_Username']);
+
+ //encrypt password!
+ global $cfg;
+ $crypter = new MyCrypt($cfg['crypt']);
+ $enc_password = $crypter->encrypt($values['IMAP_Password']);
+ $sGroup->setIMAP_Password($enc_password);
+ $sGroup->create();
+
+ return "SUCCESS";
+ }else{
+ //return NAME_TAKEN or TAG_TAKEN
+ return $notExists;
+ }
+ }else{
+ //RETURN ERROR that indicates SIZE
+ return "SIZE_ERROR";
+ }
+ }
+
+ /**
+ * check if support group name/tag doesn't exist yet.
+ * @param $name the name of the group we want to check
+ * @param $tag the tag of the group we want to check
+ * @return if name is already taken return NAME_TAKEN, else if tag is already taken return TAG_TAKEN, else return success.
+ */
+ public static function supportGroup_EntryNotExists( $name, $tag) {
+ $dbl = new DBLayer("lib");
+ //check if name is already used
+ if( $dbl->execute("SELECT * FROM support_group WHERE Name = :name",array('name' => $name))->rowCount() ){
+ return "NAME_TAKEN";
+ }
+ else if( $dbl->execute("SELECT * FROM support_group WHERE Tag = :tag",array('tag' => $tag))->rowCount() ){
+ return "TAG_TAKEN";
+ }else{
+ return "SUCCESS";
+ }
+ }
+
+
+ /**
+ * check if support group entry coupled to a given id exist or not.
+ * @param $id the id of the group we want to check
+ * @return true or false.
+ */
+ public static function supportGroup_Exists( $id) {
+ $dbl = new DBLayer("lib");
+ //check if supportgroup id exist
+ if( $dbl->execute("SELECT * FROM support_group WHERE SGroupId = :id",array('id' => $id ))->rowCount() ){
+ return true;
+ }else{
+ return false;
+ }
+ }
+
+
+ /**
+ * construct an object based on the SGroupId.
+ * @param $id the id of the group we want to construct
+ * @return the constructed support group object
+ */
+ public static function constr_SGroupId( $id) {
+ $instance = new self();
+ $instance->setSGroup($id);
+ return $instance;
+ }
+
+
+ /**
+ * get list of all users that are enlisted to a support group.
+ * @param $group_id the id of the group we want to query
+ * @return an array of ticket_user objects that are in the support group.
+ */
+ public static function getAllUsersOfSupportGroup($group_id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM `in_support_group` INNER JOIN `ticket_user` ON ticket_user.TUserId = in_support_group.User WHERE in_support_group.Group=:id", array('id' => $group_id));
+ $rows = $statement->fetchAll();
+ $result = Array();
+ foreach($rows as $row){
+ $userInstance = new Ticket_User();
+ $userInstance->setTUserId($row['TUserId']);
+ $userInstance->setPermission($row['Permission']);
+ $userInstance->setExternId($row['ExternId']);
+ $result[] = $userInstance;
+ }
+ return $result;
+ }
+
+
+ /**
+ * wrapper for deleting a support group.
+ * We will first check if the group really exists, if not than "GROUP_NOT_EXISING" will be returned.
+ * @param $group_id the id of the group we want to delete
+ * @return an array of ticket_user objects that are in the support group.
+ */
+ public static function deleteSupportGroup($group_id) {
+
+ //check if group id exists
+ if (self::supportGroup_Exists($group_id)){
+ $sGroup = new self();
+ $sGroup->setSGroupId($group_id);
+ $sGroup->delete();
+ }else{
+ //return that group doesn't exist
+ return "GROUP_NOT_EXISTING";
+ }
+
+ }
+
+ /**
+ * wrapper for deleting a user that's in a specified support group.
+ * We will first check if the group really exists, if not than "GROUP_NOT_EXISING" will be returned.
+ * Afterwards we will check if the user exists in the support group, if not "USER_NOT_IN_GROUP" will be returned.
+ * Else the users entry in the in_support_group table will be deleted and "SUCCESS" will be returned.
+ * @param $user_id the id of the user we want to remove out of the group.
+ * @param $group_id the id of the group the user should be in
+ * @return a string (SUCCESS, USER_NOT_IN_GROUP or GROUP_NOT_EXISTING)
+ */
+ public static function deleteUserOfSupportGroup( $user_id, $group_id) {
+
+ //check if group id exists
+ if (self::supportGroup_Exists($group_id)){
+
+ //check if user is in supportgroup
+ //if so, delete entry and return SUCCESS
+ if(In_Support_Group::userExistsInSGroup($user_id, $group_id) ){
+ //delete entry
+ $inSGroup = new In_Support_Group();
+ $inSGroup->setUser($user_id);
+ $inSGroup->setGroup($group_id);
+ $inSGroup->delete();
+ return "SUCCESS";
+ }
+ else{
+ //else return USER_NOT_IN_GROUP
+ return "USER_NOT_IN_GROUP";
+ }
+
+
+ }else{
+ //return that group doesn't exist
+ return "GROUP_NOT_EXISTING";
+ }
+
+ }
+
+
+ /**
+ * wrapper for adding a user to a specified support group.
+ * We will first check if the group really exists, if not than "GROUP_NOT_EXISING" will be returned.
+ * Afterwards we will check if the user exists in the support group, if so "ALREADY_ADDED" will be returned.
+ * Else the user will be added to the in_support_group table and "SUCCESS" will be returned.
+ * @param $user_id the id of the user we want to add to the group.
+ * @param $group_id the id of the group the user wants to be in
+ * @return a string (SUCCESS, ALREADY_ADDED or GROUP_NOT_EXISTING)
+ */
+ public static function addUserToSupportGroup( $user_id, $group_id) {
+ //check if group id exists
+ if (self::supportGroup_Exists($group_id)){
+ //check if user isn't in supportgroup yet
+ //if not, create entry and return SUCCESS
+ if(! In_Support_Group::userExistsInSGroup($user_id, $group_id) ){
+ //create entry
+ $inSGroup = new In_Support_Group();
+ $inSGroup->setUser($user_id);
+ $inSGroup->setGroup($group_id);
+ $inSGroup->create();
+ return "SUCCESS";
+ }
+ else{
+ //else return ALREADY_ADDED
+ return "ALREADY_ADDED";
+ }
+
+
+ }else{
+ //return that group doesn't exist
+ return "GROUP_NOT_EXISTING";
+ }
+
+ }
+
+
+ /**
+ * return all support_group objects.
+ * @return an array containing all support_group objects.
+ * @deprecated should be removed in the future, because getGroups does the same.
+ */
+ public static function getAllSupportGroups() {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->executeWithoutParams("SELECT * FROM `support_group`");
+ $row = $statement->fetchAll();
+ $result = Array();
+ foreach($row as $group){
+ $instance = new self();
+ $instance->set($group);
+ $result[] = $instance;
+ }
+ return $result;
+ }
+ ////////////////////////////////////////////Methods////////////////////////////////////////////////////
+
+
+ /**
+ * A constructor.
+ * Empty constructor
+ */
+ public function __construct() {
+ }
+
+
+ /**
+ * sets the object's attributes.
+ * @param $values should be an array of the form array('SGroupId' => groupid, 'Name' => name, 'Tag' => tag, 'GroupEmail' => mail, 'IMAP_MailServer' => server, 'IMAP_Username' => username,'IMAP_Password' => pass).
+ */
+ public function set($values) {
+ $this->setSGroupId($values['SGroupId']);
+ $this->setName($values['Name']);
+ $this->setTag($values['Tag']);
+ $this->setGroupEmail($values['GroupEmail']);
+ $this->setIMAP_MailServer($values['IMAP_MailServer']);
+ $this->setIMAP_Username($values['IMAP_Username']);
+ $this->setIMAP_Password($values['IMAP_Password']);
+ }
+
+
+ /**
+ * creates a new 'support_group' entry.
+ * this method will use the object's attributes for creating a new 'support_group' entry in the database.
+ */
+ public function create() {
+ $dbl = new DBLayer("lib");
+ $query = "INSERT INTO support_group (Name, Tag, GroupEmail, IMAP_MailServer, IMAP_Username, IMAP_Password) VALUES (:name, :tag, :groupemail, :imap_mailserver, :imap_username, :imap_password)";
+ $values = Array('name' => $this->getName(), 'tag' => $this->getTag(), 'groupemail' => $this->getGroupEmail(), 'imap_mailserver' => $this->getIMAP_MailServer(), 'imap_username' => $this->getIMAP_Username(), 'imap_password' => $this->getIMAP_Password());
+ $dbl->execute($query, $values);
+ }
+
+
+ /**
+ * loads the object's attributes.
+ * loads the object's attributes by giving a group id, it will put the matching groups attributes in the object.
+ * @param $id the id of the support group that should be loaded
+ */
+ public function load_With_SGroupId( $id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM `support_group` WHERE `SGroupId` = :id", array('id' => $id));
+ $row = $statement->fetch();
+ $this->set($row);
+ }
+
+
+ /**
+ * update the objects attributes to the db.
+ */
+ public function update(){
+ $dbl = new DBLayer("lib");
+ $query = "UPDATE `support_group` SET `Name` = :name, `Tag` = :tag, `GroupEmail` = :groupemail, `IMAP_MailServer` = :mailserver, `IMAP_Username` = :username, `IMAP_Password` = :password WHERE `SGroupId` = :id";
+ $values = Array('id' => $this->getSGroupId(), 'name' => $this->getName(), 'tag' => $this->getTag(), 'groupemail' => $this->getGroupEmail(), 'mailserver' => $this->getIMAP_MailServer(), 'username' => $this->getIMAP_Username(), 'password' => $this->getIMAP_Password() );
+ $statement = $dbl->execute($query, $values);
+ }
+
+
+ /**
+ * deletes an existing 'support_group' entry.
+ * this method will use the object's attributes for deleting an existing 'support_group' entry in the database.
+ */
+ public function delete(){
+ $dbl = new DBLayer("lib");
+ $query = "DELETE FROM `support_group` WHERE `SGroupId` = :id";
+ $values = Array('id' => $this->getSGroupId());
+ $statement = $dbl->execute($query, $values);
+ }
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get sGroupId attribute of the object.
+ */
+ public function getSGroupId(){
+ return $this->sGroupId;
+ }
+
+ /**
+ * get name attribute of the object.
+ */
+ public function getName(){
+ return $this->name;
+ }
+
+ /**
+ * get tag attribute of the object.
+ */
+ public function getTag(){
+ return $this->tag;
+ }
+
+ /**
+ * get groupEmail attribute of the object.
+ */
+ public function getGroupEmail(){
+ return $this->groupEmail;
+ }
+
+ /**
+ * get iMAP_MailServer attribute of the object.
+ */
+ public function getIMAP_MailServer(){
+ return $this->iMAP_MailServer;
+ }
+
+ /**
+ * get iMAP_Username attribute of the object.
+ */
+ public function getIMAP_Username(){
+ return $this->iMAP_Username;
+ }
+
+ /**
+ * get iMAP_Password attribute of the object.
+ */
+ public function getIMAP_Password(){
+ return $this->iMap_Password;
+ }
+ ////////////////////////////////////////////Setters////////////////////////////////////////////////////
+
+ /**
+ * set sGroupId attribute of the object.
+ * @param $id integer id of the group
+ */
+ public function setSGroupId($id){
+ $this->sGroupId = $id;
+ }
+
+ /**
+ * set name attribute of the object.
+ * @param $n name of the group
+ */
+ public function setName($n){
+ $this->name = $n;
+ }
+
+ /**
+ * set tag attribute of the object.
+ * @param $t tag of the group
+ */
+ public function setTag($t){
+ $this->tag = $t;
+ }
+
+ /**
+ * set groupEmail attribute of the object.
+ * @param $ge email of the group
+ */
+ public function setGroupEmail($ge){
+ $this->groupEmail = $ge;
+ }
+
+ /**
+ * set iMAP_MailServer attribute of the object.
+ * @param $ms mailserver of the group
+ */
+ public function setIMAP_MailServer($ms){
+ $this->iMAP_MailServer = $ms;
+ }
+
+ /**
+ * set iMAP_Username attribute of the object.
+ * @param $u imap username of the group
+ */
+ public function setIMAP_Username($u){
+ $this->iMAP_Username = $u;
+ }
+
+ /**
+ * set iMAP_Password attribute of the object.
+ * @param $p imap password of the group
+ */
+ public function setIMAP_Password($p){
+ $this->iMap_Password = $p;
+ }
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/sync.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/sync.php
new file mode 100644
index 000000000..5e8d2d37d
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/sync.php
@@ -0,0 +1,67 @@
+executeWithoutParams("SELECT * FROM ams_querycache");
+ $rows = $statement->fetchAll();
+ foreach ($rows as $record) {
+
+ $db = new DBLayer($record['db']);
+ switch($record['type']) {
+ case 'createPermissions':
+ $decode = json_decode($record['query']);
+ $values = array('username' => $decode[0]);
+ //make connection with and put into shard db & delete from the lib
+ $sth = $db->execute("SELECT UId FROM user WHERE Login= :username;", $values);
+ $result = $sth->fetchAll();
+ foreach ($result as $UId) {
+ $ins_values = array('id' => $UId['UId']);
+ $db->execute("INSERT INTO permission (UId, ClientApplication, AccessPrivilege) VALUES (:id, 'r2', 'OPEN');", $ins_values);
+ $db->execute("INSERT INTO permission (UId, ClientApplication, AccessPrivilege) VALUES (:id , 'ryzom_open', 'OPEN');", $ins_values);
+ }
+ break;
+ case 'change_pass':
+ $decode = json_decode($record['query']);
+ $values = array('user' => $decode[0], 'pass' => $decode[1]);
+ //make connection with and put into shard db & delete from the lib
+ $db->execute("UPDATE user SET Password = :pass WHERE Login = :user",$values);
+ break;
+ case 'change_mail':
+ $decode = json_decode($record['query']);
+ $values = array('user' => $decode[0], 'mail' => $decode[1]);
+ //make connection with and put into shard db & delete from the lib
+ $db->execute("UPDATE user SET Email = :mail WHERE Login = :user",$values);
+ break;
+ case 'createUser':
+ $decode = json_decode($record['query']);
+ $values = array('login' => $decode[0], 'pass' => $decode[1], 'mail' => $decode[2] );
+ //make connection with and put into shard db & delete from the lib
+ $db->execute("INSERT INTO user (Login, Password, Email) VALUES (:login, :pass, :mail)",$values);
+ break;
+ }
+ $dbl->execute("DELETE FROM ams_querycache WHERE SID=:SID",array('SID' => $record['SID']));
+ }
+ print('Syncing completed');
+ }
+ catch (PDOException $e) {
+ print('Something went wrong! The shard is probably still offline!');
+ print_r($e);
+ }
+
+ }
+}
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket.php
new file mode 100644
index 000000000..21e2614d5
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket.php
@@ -0,0 +1,578 @@
+execute(" SELECT * FROM `ticket` WHERE `TId` = :ticket_id", array('ticket_id' => $id) )->rowCount() ){
+ return true;
+ }else{
+ return false;
+ }
+ }
+
+
+ /**
+ * return an array of the possible statuses
+ * @return an array containing the string values that represent the different statuses.
+ */
+ public static function getStatusArray() {
+ return Array("Waiting on user reply","Waiting on support","Waiting on Dev reply","Closed");
+ }
+
+
+ /**
+ * return an array of the possible priorities
+ * @return an array containing the string values that represent the different priorities.
+ */
+ public static function getPriorityArray() {
+ return Array("Low","Normal","High","Super Dupa High");
+ }
+
+
+ /**
+ * return an entire ticket.
+ * returns the ticket object and an array of all replies to that ticket.
+ * @param $id the id of the ticket.
+ * @param $view_as_admin true if the viewer of the ticket is a mod, else false (depending on this it will also show the hidden comments)
+ * @return an array containing the 'ticket_obj' and a 'reply_array', which is an array containing all replies to that ticket.
+ */
+ public static function getEntireTicket($id,$view_as_admin) {
+ $ticket = new Ticket();
+ $ticket->load_With_TId($id);
+ $reply_array = Ticket_Reply::getRepliesOfTicket($id, $view_as_admin);
+ return Array('ticket_obj' => $ticket,'reply_array' => $reply_array);
+ }
+
+
+ /**
+ * return all tickets of a specific user.
+ * an array of all tickets created by a specific user are returned by this function.
+ * @param $author the id of the user of whom we want all tickets from.
+ * @return an array containing all ticket objects related to a user.
+ */
+ public static function getTicketsOf($author) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket INNER JOIN ticket_user ON ticket.Author = ticket_user.TUserId and ticket_user.ExternId=:id", array('id' => $author));
+ $row = $statement->fetchAll();
+ $result = Array();
+ foreach($row as $ticket){
+ $instance = new self();
+ $instance->setTId($ticket['TId']);
+ $instance->setTimestamp($ticket['Timestamp']);
+ $instance->setTitle($ticket['Title']);
+ $instance->setStatus($ticket['Status']);
+ $instance->setQueue($ticket['Queue']);
+ $instance->setTicket_Category($ticket['Ticket_Category']);
+ $instance->setAuthor($ticket['Author']);
+ $result[] = $instance;
+ }
+ return $result;
+ }
+
+
+
+ /**
+ * function that creates a new ticket.
+ * A new ticket will be created, in case the extra_info != 0 and the http request came from ingame, then a ticket_info page will be created.
+ * A log entry will be written, depending on the $real_authors value. In case the for_support_group parameter is set, the ticket will be forwarded immediately.
+ * Also the mail handler will create a new email that will be sent to the author to notify him that his ticket is freshly created.
+ * @param $title the title we want to give to the ticket.
+ * @param $content the content we want to give to the starting post of the ticket.
+ * @param $category the id of the category that should be related to the ticket.
+ * @param $author the person who's id will be stored in the database as creator of the ticket.
+ * @param $real_author should be the same id, or a moderator/admin who creates a ticket for another user (this is used for logging purposes).
+ * @param $for_support_group in case you directly want to forward the ticket after creating it. (default value = 0 = don't forward)
+ * @param $extra_info used for creating an ticket_info page related to the ticket, this only happens when the ticket is made ingame.
+ * @return the created tickets id.
+ */
+ public static function create_Ticket( $title, $content, $category, $author, $real_author, $for_support_group = 0, $extra_info = 0) {
+
+ //create the new ticket!
+ $ticket = new Ticket();
+ $values = array("Title" => $title, "Timestamp"=>0, "Status"=> 1, "Queue"=> 0, "Ticket_Category" => $category, "Author" => $author, "Priority" => 0);
+ $ticket->set($values);
+ $ticket->create();
+ $ticket_id = $ticket->getTId();
+
+ //if ingame then add an extra info
+ if(Helpers::check_if_game_client() && $extra_info != 0){
+ $extra_info['Ticket'] = $ticket_id;
+ Ticket_Info::create_Ticket_Info($extra_info);
+ }
+
+ //write a log entry
+ if ( $author == $real_author){
+ Ticket_Log::createLogEntry( $ticket_id, $author, 1);
+ }else{
+ Ticket_Log::createLogEntry( $ticket_id, $real_author, 2, $author);
+ }
+ Ticket_Reply::createReply($content, $author, $ticket_id, 0, $author);
+
+ //forwards the ticket directly after creation to the supposed support group
+ if($for_support_group){
+ Ticket::forwardTicket(0, $ticket_id, $for_support_group);
+ }
+
+ //send email that new ticket has been created
+ Mail_Handler::send_ticketing_mail($ticket->getAuthor(), $ticket, $content, "NEW", $ticket->getForwardedGroupId());
+ return $ticket_id;
+
+ }
+
+
+ /**
+ * updates the ticket's status.
+ * A log entry about this will be created only if the newStatus is different from the current status.
+ * @param $ticket_id the id of the ticket of which we want to change the status.
+ * @param $newStatus the new status value (integer)
+ * @param $author the user (id) that performed the update status action
+ */
+ public static function updateTicketStatus( $ticket_id, $newStatus, $author) {
+
+ $ticket = new Ticket();
+ $ticket->load_With_TId($ticket_id);
+ if ($ticket->getStatus() != $newStatus){
+ $ticket->setStatus($newStatus);
+ Ticket_Log::createLogEntry( $ticket_id, $author, 5, $newStatus);
+ }
+ $ticket->update();
+
+ }
+
+
+ /**
+ * updates the ticket's status & priority.
+ * A log entry about this will be created only if the newStatus is different from the current status and also when the newPriority is different from the current priority.
+ * @todo break this function up into a updateStatus (already exists) and updatePriority function and perhaps write a wrapper function for the combo.
+ * @param $ticket_id the id of the ticket of which we want to change the status & priority
+ * @param $newStatus the new status value (integer)
+ * @param $newPriority the new priority value (integer)
+ * @param $author the user (id) that performed the update
+ */
+ public static function updateTicketStatusAndPriority( $ticket_id, $newStatus, $newPriority, $author) {
+
+ $ticket = new Ticket();
+ $ticket->load_With_TId($ticket_id);
+ if ($ticket->getStatus() != $newStatus){
+ $ticket->setStatus($newStatus);
+ Ticket_Log::createLogEntry( $ticket_id, $author, 5, $newStatus);
+ }
+ if ($ticket->getPriority() != $newPriority){
+ $ticket->setPriority($newPriority);
+ Ticket_Log::createLogEntry( $ticket_id, $author, 6, $newPriority);
+ }
+ $ticket->update();
+
+ }
+
+
+ /**
+ * return the latest reply of a ticket
+ * @param $ticket_id the id of the ticket.
+ * @return a ticket_reply object.
+ */
+ public static function getLatestReply( $ticket_id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket_reply WHERE Ticket =:id ORDER BY TReplyId DESC LIMIT 1 ", array('id' => $ticket_id));
+ $reply = new Ticket_Reply();
+ $reply->set($statement->fetch());
+ return $reply;
+ }
+
+
+ /**
+ * create a new reply for a ticket.
+ * A reply will only be added if the content isn't empty and if the ticket isn't closed.
+ * The ticket creator will be notified by email that someone else replied on his ticket.
+ * @param $content the content of the reply
+ * @param $author the author of the reply
+ * @param $ticket_id the id of the ticket to which we want to add the reply.
+ * @param $hidden boolean that specifies if the reply should only be shown to mods/admins or all users.
+ */
+ public static function createReply($content, $author, $ticket_id, $hidden){
+ //if not empty
+ if(! ( Trim ( $content ) === '' )){
+ $content = filter_var($content, FILTER_SANITIZE_STRING);
+ $ticket = new Ticket();
+ $ticket->load_With_TId($ticket_id);
+ //if status is not closed
+ if($ticket->getStatus() != 3){
+ Ticket_Reply::createReply($content, $author, $ticket_id, $hidden, $ticket->getAuthor());
+
+ //notify ticket author that a new reply is added!
+ if($ticket->getAuthor() != $author){
+ Mail_Handler::send_ticketing_mail($ticket->getAuthor(), $ticket, $content, "REPLY", $ticket->getForwardedGroupId());
+ }
+
+
+ }else{
+ //TODO: Show error message that ticket is closed
+ }
+ }else{
+ //TODO: Show error content is empty
+ }
+ }
+
+
+ /**
+ * assign a ticket to a user.
+ * Checks if the ticket exists, if so then it will try to assign the user to it, a log entry will be written about this.
+ * @param $user_id the id of user trying to be assigned to the ticket.
+ * @param $ticket_id the id of the ticket that we try to assign to the user.
+ * @return SUCCESS_ASSIGNED, TICKET_NOT_EXISTING or ALREADY_ASSIGNED
+ */
+ public static function assignTicket($user_id, $ticket_id){
+ if(self::ticketExists($ticket_id)){
+ $returnvalue = Assigned::assignTicket($user_id, $ticket_id);
+ Ticket_Log::createLogEntry( $ticket_id, $user_id, 7);
+ return $returnvalue;
+ }else{
+ return "TICKET_NOT_EXISTING";
+ }
+ }
+
+
+ /**
+ * unassign a ticket of a user.
+ * Checks if the ticket exists, if so then it will try to unassign the user of it, a log entry will be written about this.
+ * @param $user_id the id of user trying to be assigned to the ticket.
+ * @param $ticket_id the id of the ticket that we try to assign to the user.
+ * @return SUCCESS_UNASSIGNED, TICKET_NOT_EXISTING or NOT_ASSIGNED
+ */
+ public static function unAssignTicket($user_id, $ticket_id){
+ if(self::ticketExists($ticket_id)){
+ $returnvalue = Assigned::unAssignTicket($user_id, $ticket_id);
+ Ticket_Log::createLogEntry( $ticket_id, $user_id, 9);
+ return $returnvalue;
+ }else{
+ return "TICKET_NOT_EXISTING";
+ }
+ }
+
+
+ /**
+ * forward a ticket to a specific support group.
+ * Checks if the ticket exists, if so then it will try to forward the ticket to the support group specified, a log entry will be written about this.
+ * if no log entry should be written then the user_id should be 0, else te $user_id will be used in the log to specify who forwarded it.
+ * @param $user_id the id of user trying to forward the ticket.
+ * @param $ticket_id the id of the ticket that we try to forward to a support group.
+ * @param $group_id the id of the support group.
+ * @return SUCCESS_FORWARDED, TICKET_NOT_EXISTING or INVALID_SGROUP
+ */
+ public static function forwardTicket($user_id, $ticket_id, $group_id){
+ if(self::ticketExists($ticket_id)){
+ if(isset($group_id) && $group_id != ""){
+ //forward the ticket
+ $returnvalue = Forwarded::forwardTicket($group_id, $ticket_id);
+
+ if($user_id != 0){
+ //unassign the ticket incase the ticket is assined to yourself
+ self::unAssignTicket($user_id, $ticket_id);
+ //make a log entry of this action
+ Ticket_Log::createLogEntry( $ticket_id, $user_id, 8, $group_id);
+ }
+ return $returnvalue;
+ }else{
+ return "INVALID_SGROUP";
+ }
+ }else{
+ return "TICKET_NOT_EXISTING";
+ }
+ }
+
+
+
+
+ ////////////////////////////////////////////Methods////////////////////////////////////////////////////
+
+ /**
+ * A constructor.
+ * Empty constructor
+ */
+ public function __construct() {
+
+ }
+
+
+ /**
+ * sets the object's attributes.
+ * @param $values should be an array of the form array('TId' => ticket_id, 'Title' => title, 'Status'=> status, 'Timestamp' => ts, 'Queue' => queue,
+ * 'Ticket_Category' => tc, 'Author' => author, 'Priority' => priority).
+ */
+ public function set($values){
+ if(isset($values['TId'])){
+ $this->tId = $values['TId'];
+ }
+ $this->title = $values['Title'];
+ $this->status = $values['Status'];
+ $this->timestamp = $values['Timestamp'];
+ $this->queue = $values['Queue'];
+ $this->ticket_category = $values['Ticket_Category'];
+ $this->author = $values['Author'];
+ $this->priority = $values['Priority'];
+ }
+
+
+ /**
+ * creates a new 'ticket' entry.
+ * this method will use the object's attributes for creating a new 'ticket' entry in the database.
+ */
+ public function create(){
+ $dbl = new DBLayer("lib");
+ $query = "INSERT INTO ticket (Timestamp, Title, Status, Queue, Ticket_Category, Author, Priority) VALUES (now(), :title, :status, :queue, :tcat, :author, :priority)";
+ $values = Array('title' => $this->title, 'status' => $this->status, 'queue' => $this->queue, 'tcat' => $this->ticket_category, 'author' => $this->author, 'priority' => $this->priority);
+ $this->tId = $dbl->executeReturnId($query, $values); ;
+ }
+
+
+ /**
+ * loads the object's attributes.
+ * loads the object's attributes by giving a TId (ticket id).
+ * @param $id the id of the ticket that should be loaded
+ */
+ public function load_With_TId( $id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket WHERE TId=:id", array('id' => $id));
+ $row = $statement->fetch();
+ $this->tId = $row['TId'];
+ $this->timestamp = $row['Timestamp'];
+ $this->title = $row['Title'];
+ $this->status = $row['Status'];
+ $this->queue = $row['Queue'];
+ $this->ticket_category = $row['Ticket_Category'];
+ $this->author = $row['Author'];
+ $this->priority = $row['Priority'];
+ }
+
+
+ /**
+ * update the objects attributes to the db.
+ */
+ public function update(){
+ $dbl = new DBLayer("lib");
+ $query = "UPDATE ticket SET Timestamp = :timestamp, Title = :title, Status = :status, Queue = :queue, Ticket_Category = :tcat, Author = :author, Priority = :priority WHERE TId=:id";
+ $values = Array('id' => $this->tId, 'timestamp' => $this->timestamp, 'title' => $this->title, 'status' => $this->status, 'queue' => $this->queue, 'tcat' => $this->ticket_category, 'author' => $this->author, 'priority' => $this->priority);
+ $statement = $dbl->execute($query, $values);
+ }
+
+
+ /**
+ * check if a ticket has a ticket_info page or not.
+ * @return true or false
+ */
+ public function hasInfo(){
+ return Ticket_Info::TicketHasInfo($this->getTId());
+ }
+
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get tId attribute of the object.
+ */
+ public function getTId(){
+ return $this->tId;
+ }
+
+ /**
+ * get timestamp attribute of the object in the format defined in the outputTime function of the Helperclass.
+ */
+ public function getTimestamp(){
+ return Helpers::outputTime($this->timestamp);
+ }
+
+ /**
+ * get title attribute of the object.
+ */
+ public function getTitle(){
+ return $this->title;
+ }
+
+ /**
+ * get status attribute of the object.
+ */
+ public function getStatus(){
+ return $this->status;
+ }
+
+ /**
+ * get status attribute of the object in the form of text (string).
+ */
+ public function getStatusText(){
+ $statusArray = Ticket::getStatusArray();
+ return $statusArray[$this->getStatus()];
+ }
+
+ /**
+ * get category attribute of the object in the form of text (string).
+ */
+ public function getCategoryName(){
+ $category = Ticket_Category::constr_TCategoryId($this->getTicket_Category());
+ return $category->getName();
+ }
+
+ /**
+ * get queue attribute of the object.
+ */
+ public function getQueue(){
+ return $this->queue;
+ }
+
+ /**
+ * get ticket_category attribute of the object (int).
+ */
+ public function getTicket_Category(){
+ return $this->ticket_category;
+ }
+
+ /**
+ * get author attribute of the object (int).
+ */
+ public function getAuthor(){
+ return $this->author;
+ }
+
+ /**
+ * get priority attribute of the object (int).
+ */
+ public function getPriority(){
+ return $this->priority;
+ }
+
+ /**
+ * get priority attribute of the object in the form of text (string).
+ */
+ public function getPriorityText(){
+ $priorityArray = Ticket::getPriorityArray();
+ return $priorityArray[$this->getPriority()];
+ }
+
+ /**
+ * get the user assigned to the ticket.
+ * or return 0 in case not assigned.
+ */
+ public function getAssigned(){
+ $user_id = Assigned::getUserAssignedToTicket($this->getTId());
+ if ($user_id == ""){
+ return 0;
+ }else{
+ return $user_id;
+ }
+ }
+
+ /**
+ * get the name of the support group to whom the ticket is forwarded
+ * or return 0 in case not forwarded.
+ */
+ public function getForwardedGroupName(){
+ $group_id = Forwarded::getSGroupOfTicket($this->getTId());
+ if ($group_id == ""){
+ return 0;
+ }else{
+ return Support_Group::getGroup($group_id)->getName();
+ }
+ }
+
+ /**
+ * get the id of the support group to whom the ticket is forwarded
+ * or return 0 in case not forwarded.
+ */
+ public function getForwardedGroupId(){
+ $group_id = Forwarded::getSGroupOfTicket($this->getTId());
+ if ($group_id == ""){
+ return 0;
+ }else{
+ return $group_id;
+ }
+ }
+ ////////////////////////////////////////////Setters////////////////////////////////////////////////////
+
+ /**
+ * set tId attribute of the object.
+ * @param $id integer id of the ticket
+ */
+ public function setTId($id){
+ $this->tId = $id;
+ }
+
+ /**
+ * set timestamp attribute of the object.
+ * @param $ts timestamp of the ticket
+ */
+ public function setTimestamp($ts){
+ $this->timestamp = $ts;
+ }
+
+ /**
+ * set title attribute of the object.
+ * @param $t title of the ticket
+ */
+ public function setTitle($t){
+ $this->title = $t;
+ }
+
+ /**
+ * set status attribute of the object.
+ * @param $s status of the ticket(int)
+ */
+ public function setStatus($s){
+ $this->status = $s;
+ }
+
+ /**
+ * set queue attribute of the object.
+ * @param $q queue of the ticket
+ */
+ public function setQueue($q){
+ $this->queue = $q;
+ }
+
+ /**
+ * set ticket_category attribute of the object.
+ * @param $tc ticket_category id of the ticket(int)
+ */
+ public function setTicket_Category($tc){
+ $this->ticket_category = $tc;
+ }
+
+ /**
+ * set author attribute of the object.
+ * @param $a author of the ticket
+ */
+ public function setAuthor($a){
+ $this->author = $a;
+ }
+
+ /**
+ * set priority attribute of the object.
+ * @param $p priority of the ticket
+ */
+ public function setPriority($p){
+ $this->priority = $p;
+ }
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_category.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_category.php
new file mode 100644
index 000000000..92e603d12
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_category.php
@@ -0,0 +1,129 @@
+ $name);
+ $dbl->execute($query, $values);
+
+ }
+
+
+ /**
+ * construct a category object based on the TCategoryId.
+ * @return constructed element based on TCategoryId
+ */
+ public static function constr_TCategoryId( $id) {
+ $instance = new self();
+ $instance->setTCategoryId($id);
+ return $instance;
+ }
+
+
+ /**
+ * return a list of all category objects.
+ * @return an array consisting of all category objects.
+ */
+ public static function getAllCategories() {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->executeWithoutParams("SELECT * FROM ticket_category");
+ $row = $statement->fetchAll();
+ $result = Array();
+ foreach($row as $category){
+ $instance = new self();
+ $instance->tCategoryId = $category['TCategoryId'];
+ $instance->name = $category['Name'];
+ $result[] = $instance;
+ }
+ return $result;
+ }
+
+
+ ////////////////////////////////////////////Methods////////////////////////////////////////////////////
+
+ /**
+ * A constructor.
+ * Empty constructor
+ */
+ public function __construct() {
+ }
+
+
+ /**
+ * loads the object's attributes.
+ * loads the object's attributes by giving a categories id.
+ * @param $id the id of the ticket_category that should be loaded
+ */
+ public function load_With_TCategoryId( $id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket_category WHERE TCategoryId=:id", array('id' => $id));
+ $row = $statement->fetch();
+ $this->tCategoryId = $row['TCategoryId'];
+ $this->name = $row['Name'];
+ }
+
+
+ /**
+ * update object attributes to the DB.
+ */
+ public function update(){
+ $dbl = new DBLayer("lib");
+ $query = "UPDATE ticket_category SET Name = :name WHERE TCategoryId=:id";
+ $values = Array('id' => $this->tCategoryId, 'name' => $this->name);
+ $statement = $dbl->execute($query, $values);
+ }
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get name attribute of the object.
+ */
+ public function getName(){
+ if ($this->name == ""){
+ $this->load_With_TCategoryId($this->tCategoryId);
+ }
+ return $this->name;
+ }
+
+ /**
+ * get tCategoryId attribute of the object.
+ */
+ public function getTCategoryId(){
+ return $this->tCategoryId;
+ }
+
+
+ ////////////////////////////////////////////Setters////////////////////////////////////////////////////
+
+ /**
+ * set name attribute of the object.
+ * @param $n name of the category
+ */
+ public function setName($n){
+ $this->name = $n;
+ }
+
+ /**
+ * set tCategoryId attribute of the object.
+ * @param $id integer id of the category
+ */
+ public function setTCategoryId($id){
+ $this->tCategoryId = $id;
+ }
+
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_content.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_content.php
new file mode 100644
index 000000000..445cad867
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_content.php
@@ -0,0 +1,113 @@
+setTContentId($id);
+ return $instance;
+ }
+
+
+ ////////////////////////////////////////////Methods////////////////////////////////////////////////////
+
+ /**
+ * A constructor.
+ * Empty constructor
+ */
+ public function __construct() {
+ }
+
+
+ /**
+ * creates a new 'tickt_content' entry.
+ * this method will use the object's attributes for creating a new 'ticket_content' entry in the database.
+ */
+ public function create() {
+ $dbl = new DBLayer("lib");
+ $query = "INSERT INTO ticket_content (Content) VALUES (:content)";
+ $values = Array('content' => $this->content);
+ $this->tContentId = $dbl->executeReturnId($query, $values); ;
+ }
+
+
+ /**
+ * loads the object's attributes.
+ * loads the object's attributes by giving a ticket_content's id,
+ * @param $id the id of the ticket_content entry that should be loaded
+ */
+ public function load_With_TContentId( $id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket_content WHERE TContentId=:id", array('id' => $id));
+ $row = $statement->fetch();
+ $this->tContentId = $row['TContentId'];
+ $this->content = $row['Content'];
+ }
+
+ /**
+ * update the object's attributes to the database.
+ */
+ public function update(){
+ $dbl = new DBLayer("lib");
+ $query = "UPDATE ticket_content SET Content = :content WHERE TContentId=:id";
+ $values = Array('id' => $this->tContentId, 'content' => $this->content);
+ $statement = $dbl->execute($query, $values);
+ }
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get content attribute of the object.
+ */
+ public function getContent(){
+ if ($this->content == ""){
+ $this->load_With_TContentId($this->tContentId);
+ }
+ return $this->content;
+ }
+
+ /**
+ * get tContentId attribute of the object.
+ */
+ public function getTContentId(){
+ return $this->tContentId;
+ }
+
+
+ ////////////////////////////////////////////Setters////////////////////////////////////////////////////
+
+ /**
+ * set content attribute of the object.
+ * @param $c content of a reply
+ */
+ public function setContent($c){
+ $this->content = $c;
+ }
+
+ /**
+ * set tContentId attribute of the object.
+ * @param $c integer id of ticket_content entry
+ */
+ public function setTContentId($c){
+ $this->tContentId = $c;
+ }
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_info.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_info.php
new file mode 100644
index 000000000..fc852d093
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_info.php
@@ -0,0 +1,414 @@
+set($info_array);
+ $ticket_info->create();
+ }
+
+
+ /**
+ * check if a specific ticket has extra info or not.
+ * Not all tickets have extra info, only tickets made ingame do. This function checks if a specific ticket does have a ticket_info entry linked to it.
+ * @param $ticket_id the id of the ticket that we want to query
+ * @return true or false
+ */
+ public static function TicketHasInfo($ticket_id) {
+ $dbl = new DBLayer("lib");
+ //check if ticket is already assigned
+ if( $dbl->execute(" SELECT * FROM `ticket_info` WHERE `Ticket` = :ticket_id", array('ticket_id' => $ticket_id) )->rowCount() ){
+ return true;
+ }else{
+ return false;
+ }
+ }
+
+
+ ////////////////////////////////////////////Methods////////////////////////////////////////////////////
+
+ /**
+ * A constructor.
+ * Empty constructor
+ */
+ public function __construct() {
+ }
+
+
+ /**
+ * sets the object's attributes.
+ * @param $values should be an array.
+ */
+ public function set($values) {
+ $this->setTicket($values['Ticket']);
+ $this->setShardId($values['ShardId']);
+ $this->setUser_Position($values['UserPosition']);
+ $this->setView_Position($values['ViewPosition']);
+ $this->setClient_Version($values['ClientVersion']);
+ $this->setPatch_Version($values['PatchVersion']);
+ $this->setServer_Tick($values['ServerTick']);
+ $this->setConnect_State($values['ConnectState']);
+ $this->setLocal_Address($values['LocalAddress']);
+ $this->setMemory($values['Memory']);
+ $this->setOS($values['OS']);
+ $this->setProcessor($values['Processor']);
+ $this->setCPUId($values['CPUID']);
+ $this->setCPU_Mask($values['CpuMask']);
+ $this->setHT($values['HT']);
+ $this->setNel3D($values['NeL3D']);
+ $this->setUser_Id($values['UserId']);
+
+ }
+
+ /**
+ * loads the object's attributes by using a ticket_info id.
+ * loads the object's attributes by giving a ticket_info's entry id.
+ * @param $id the id of the ticket_info entry that should be loaded
+ */
+ public function load_With_TInfoId( $id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket_info WHERE TInfoId=:id", array('id' => $id));
+ $row = $statement->fetch();
+ $this->set($row);
+ }
+
+
+ /**
+ * loads the object's attributes by using a ticket's id.
+ * loads the object's attributes by giving a ticket's entry id.
+ * @param $id the id of the ticket, the ticket_info entry of that ticket should be loaded.
+ */
+ public function load_With_Ticket( $id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket_info WHERE Ticket=:id", array('id' => $id));
+ $row = $statement->fetch();
+ $this->set($row);
+ }
+
+
+ /**
+ * creates a new 'ticket_info' entry.
+ * this method will use the object's attributes for creating a new 'ticket_info' entry in the database.
+ */
+ public function create() {
+ $dbl = new DBLayer("lib");
+ $query = "INSERT INTO ticket_info ( Ticket, ShardId, UserPosition,ViewPosition, ClientVersion, PatchVersion,ServerTick, ConnectState, LocalAddress, Memory, OS,
+Processor, CPUID, CpuMask, HT, NeL3D, UserId) VALUES ( :ticket, :shardid, :userposition, :viewposition, :clientversion, :patchversion, :servertick, :connectstate, :localaddress, :memory, :os, :processor, :cpuid, :cpu_mask, :ht, :nel3d, :user_id )";
+ $values = Array('ticket' => $this->getTicket(), 'shardid' => $this->getShardId(), 'userposition' => $this->getUser_Position(), 'viewposition' => $this->getView_Position(), 'clientversion' => $this->getClient_Version(),
+'patchversion' => $this->getPatch_Version(), 'servertick' => $this->getServer_Tick(), 'connectstate' => $this->getConnect_State(), 'localaddress' => $this->getLocal_Address(), 'memory' => $this->getMemory(), 'os'=> $this->getOS(), 'processor' => $this->getProcessor(), 'cpuid' => $this->getCPUId(),
+'cpu_mask' => $this->getCpu_Mask(), 'ht' => $this->getHT(), 'nel3d' => $this->getNel3D(), 'user_id' => $this->getUser_Id());
+ $dbl->execute($query, $values);
+ }
+
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get tInfoId attribute of the object.
+ */
+ public function getTInfoId(){
+ return $this->tInfoId;
+ }
+
+ /**
+ * get ticket attribute of the object.
+ */
+ public function getTicket(){
+ return $this->ticket;
+ }
+
+ /**
+ * get shardid attribute of the object.
+ */
+ public function getShardId(){
+ return $this->shardid;
+ }
+
+ /**
+ * get user_position attribute of the object.
+ */
+ public function getUser_Position(){
+ return $this->user_position;
+ }
+
+ /**
+ * get view_position attribute of the object.
+ */
+ public function getView_Position(){
+ return $this->view_position;
+ }
+
+ /**
+ * get client_version attribute of the object.
+ */
+ public function getClient_Version(){
+ return $this->client_version;
+ }
+
+ /**
+ * get patch_version attribute of the object.
+ */
+ public function getPatch_Version(){
+ return $this->patch_version;
+ }
+
+ /**
+ * get server_tick attribute of the object.
+ */
+ public function getServer_Tick(){
+ return $this->server_tick;
+ }
+
+ /**
+ * get connect_state attribute of the object.
+ */
+ public function getConnect_State(){
+ return $this->connect_state;
+ }
+
+ /**
+ * get local_address attribute of the object.
+ */
+ public function getLocal_Address(){
+ return $this->local_address;
+ }
+
+ /**
+ * get memory attribute of the object.
+ */
+ public function getMemory(){
+ return $this->memory;
+ }
+
+ /**
+ * get os attribute of the object.
+ */
+ public function getOS(){
+ return $this->os;
+ }
+
+ /**
+ * get processor attribute of the object.
+ */
+ public function getProcessor(){
+ return $this->processor;
+ }
+
+ /**
+ * get cpu_id attribute of the object.
+ */
+ public function getCPUId(){
+ return $this->cpu_id;
+ }
+
+ /**
+ * get cpu_mask attribute of the object.
+ */
+ public function getCPU_Mask(){
+ return $this->cpu_mask;
+ }
+
+ /**
+ * get ht attribute of the object.
+ */
+ public function getHT(){
+ return $this->ht;
+ }
+
+ /**
+ * get nel3d attribute of the object.
+ */
+ public function getNel3D(){
+ return $this->nel3d;
+ }
+
+ /**
+ * get user_id attribute of the object.
+ */
+ public function getUser_Id(){
+ return $this->user_id;
+ }
+
+
+ ////////////////////////////////////////////Setters////////////////////////////////////////////////////
+
+ /**
+ * set tInfoId attribute of the object.
+ * @param $id integer id of ticket_info object itself
+ */
+ public function setTInfoId($id){
+ $this->tInfoId = $id;
+ }
+
+ /**
+ * set ticket attribute of the object.
+ * @param $t integer id of the ticket linked to the info object
+ */
+ public function setTicket($t){
+ $this->ticket = $t;
+ }
+
+ /**
+ * set shardid attribute of the object.
+ * @param $s (integer) shard id
+ */
+ public function setShardId($s){
+ $this->shardid = $s;
+ }
+
+ /**
+ * set user_position attribute of the object.
+ * @param $u the users position
+ */
+ public function setUser_Position($u){
+ $this->user_position = $u;
+ }
+
+ /**
+ * set view_position attribute of the object.
+ * @param $v the view position
+ */
+ public function setView_Position($v){
+ $this->view_position = $v;
+ }
+
+ /**
+ * set client_version attribute of the object.
+ * @param $c client version number
+ */
+ public function setClient_Version($c){
+ $this->client_version = $c;
+ }
+
+ /**
+ * set patch_version attribute of the object.
+ * @param $p patch version number
+ */
+ public function setPatch_Version($p){
+ $this->patch_version = $p;
+ }
+
+ /**
+ * set server_tick attribute of the object.
+ * @param $s integer that resembles the server tick
+ */
+ public function setServer_Tick($s){
+ $this->server_tick = $s;
+ }
+
+ /**
+ * set connect_state attribute of the object.
+ * @param $c string that defines the connect state.
+ */
+ public function setConnect_State($c){
+ $this->connect_state = $c;
+ }
+
+ /**
+ * set local_address attribute of the object.
+ * @param $l local address
+ */
+ public function setLocal_Address($l){
+ $this->local_address = $l;
+ }
+
+ /**
+ * set memory attribute of the object.
+ * @param $m memory usage
+ */
+ public function setMemory($m){
+ $this->memory = $m;
+ }
+
+ /**
+ * set os attribute of the object.
+ * @param $o set os version information
+ */
+ public function setOS($o){
+ $this->os = $o;
+ }
+
+ /**
+ * set processor attribute of the object.
+ * @param $p processor information
+ */
+ public function setProcessor($p){
+ $this->processor = $p;
+ }
+
+ /**
+ * set cpu_id attribute of the object.
+ * @param $c cpu id information
+ */
+ public function setCPUId($c){
+ $this->cpu_id = $c;
+ }
+
+ /**
+ * set cpu_mask attribute of the object.
+ * @param $c mask of the cpu
+ */
+ public function setCPU_Mask($c){
+ $this->cpu_mask = $c;
+ }
+
+ /**
+ * set ht attribute of the object.
+ */
+ public function setHT($h){
+ $this->ht = $h;
+ }
+
+ /**
+ * set nel3d attribute of the object.
+ * @param $n version information about NeL3D
+ */
+ public function setNel3D($n){
+ $this->nel3d = $n;
+ }
+
+ /**
+ * set user_id attribute of the object.
+ * @param $u the user_id.
+ */
+ public function setUser_Id($u){
+ $this->user_id = $u;
+ }
+
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_log.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_log.php
new file mode 100644
index 000000000..bfb679348
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_log.php
@@ -0,0 +1,276 @@
+execute("SELECT * FROM ticket_log INNER JOIN ticket_user ON ticket_log.Author = ticket_user.TUserId and ticket_log.Ticket=:id ORDER BY ticket_log.TLogId ASC", array('id' => $ticket_id));
+ $row = $statement->fetchAll();
+ $result = Array();
+ foreach($row as $log){
+ $instanceAuthor = Ticket_User::constr_TUserId($log['Author']);
+ $instanceAuthor->setExternId($log['ExternId']);
+ $instanceAuthor->setPermission($log['Permission']);
+
+ $instanceLog = new self();
+ $instanceLog->setTLogId($log['TLogId']);
+ $instanceLog->setTimestamp($log['Timestamp']);
+ $instanceLog->setAuthor($instanceAuthor);
+ $instanceLog->setTicket($ticket_id);
+ $instanceLog->setQuery($log['Query']);
+ $result[] = $instanceLog;
+ }
+ return $result;
+ }
+
+
+ /**
+ * create a new log entry.
+ * It will check if the $TICKET_LOGGING global var is true, this var is used to turn logging on and off. In case it's on, the log message will be stored.
+ * the action id and argument (which is -1 by default), will be json encoded and stored in the query field in the db.
+ * @param $ticket_id the id of the ticket related to the new log entry
+ * @param $author_id the id of the user that instantiated the logging.
+ * @param $action the action id (see the list in the class description)
+ * @param $arg argument for the action (default = -1)
+ */
+ public static function createLogEntry( $ticket_id, $author_id, $action, $arg = -1) {
+ global $TICKET_LOGGING;
+ if($TICKET_LOGGING){
+ $dbl = new DBLayer("lib");
+ $query = "INSERT INTO ticket_log (Timestamp, Query, Ticket, Author) VALUES (now(), :query, :ticket, :author )";
+ $values = Array('ticket' => $ticket_id, 'author' => $author_id, 'query' => json_encode(array($action,$arg)));
+ $dbl->execute($query, $values);
+ }
+ }
+
+
+ /**
+ * return constructed element based on TLogId
+ * @param $id ticket_log id of the entry that we want to load into our object.
+ * @return constructed ticket_log object.
+ */
+ public static function constr_TLogId( $id) {
+ $instance = new self();
+ $instance->setTLogId($id);
+ return $instance;
+ }
+
+ /**
+ * return all log entries related to a ticket.
+ * @param $ticket_id the id of the ticket of which we want all related log entries returned.
+ * @return an array of ticket_log objects, here the author is an integer.
+ * @todo only use one of the 2 comparable functions in the future and make the other depricated.
+ */
+ public static function getAllLogs($ticket_id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket_log INNER JOIN ticket_user ON ticket_log.Author = ticket_user.TUserId and ticket_log.Ticket=:id", array('id' => $ticket_id));
+ $row = $statement->fetchAll();
+ $result = Array();
+ foreach($row as $log){
+ $instance = new self();
+ $instance->set($log);
+ $result[] = $instance;
+ }
+ return $result;
+ }
+
+
+ ////////////////////////////////////////////Methods////////////////////////////////////////////////////
+
+ /**
+ * A constructor.
+ * Empty constructor
+ */
+ public function __construct() {
+ }
+
+ /**
+ * sets the object's attributes.
+ * @param $values should be an array.
+ */
+ public function set($values) {
+ $this->setTLogId($values['TLogId']);
+ $this->setTimestamp($values['Timestamp']);
+ $this->setQuery($values['Query']);
+ $this->setTicket($values['Ticket']);
+ $this->setAuthor($values['Author']);
+ }
+
+ /**
+ * loads the object's attributes.
+ * loads the object's attributes by giving a ticket_log entries ID (TLogId).
+ * @param id the id of the ticket_log entry that should be loaded
+ */
+ public function load_With_TLogId( $id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket_log WHERE TLogId=:id", array('id' => $id));
+ $row = $statement->fetch();
+ $this->set($row);
+ }
+
+
+ /**
+ * update attributes of the object to the DB.
+ */
+ public function update(){
+ $dbl = new DBLayer("lib");
+ $query = "UPDATE ticket_log SET Timestamp = :timestamp, Query = :query, Author = :author, Ticket = :ticket WHERE TLogId=:id";
+ $values = Array('id' => $this->getTLogId(), 'timestamp' => $this->getTimestamp(), 'query' => $this->getQuery(), 'author' => $this->getAuthor(), 'ticket' => $this->getTicket() );
+ $statement = $dbl->execute($query, $values);
+ }
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get tLogId attribute of the object.
+ */
+ public function getTLogId(){
+ return $this->tLogId;
+ }
+
+ /**
+ * get timestamp attribute of the object.
+ */
+ public function getTimestamp(){
+ return Helpers::outputTime($this->timestamp);
+ }
+
+ /**
+ * get query attribute of the object.
+ */
+ public function getQuery(){
+ return $this->query;
+ }
+
+ /**
+ * get author attribute of the object.
+ */
+ public function getAuthor(){
+ return $this->author;
+ }
+
+ /**
+ * get ticket attribute of the object.
+ */
+ public function getTicket(){
+ return $this->ticket;
+ }
+
+ /**
+ * get the action id out of the query by decoding it.
+ */
+ public function getAction(){
+ $decodedQuery = json_decode($this->query);
+ return $decodedQuery[0];
+ }
+
+ /**
+ * get the argument out of the query by decoding it.
+ */
+ public function getArgument(){
+ $decodedQuery = json_decode($this->query);
+ return $decodedQuery[1];
+ }
+
+ /**
+ * get the action text(string) array.
+ * this is being read from the language .ini files.
+ */
+ public function getActionTextArray(){
+ $variables = Helpers::handle_language();
+ $result = array();
+ foreach ( $variables['ticket_log'] as $key => $value ){
+ $result[$key] = $value;
+ }
+ return $result;
+ }
+
+ ////////////////////////////////////////////Setters////////////////////////////////////////////////////
+
+ /**
+ * set tLogId attribute of the object.
+ * @param $id integer id of the log entry
+ */
+ public function setTLogId($id){
+ $this->tLogId = $id;
+ }
+
+ /**
+ * set timestamp attribute of the object.
+ * @param $t timestamp of the log entry
+ */
+ public function setTimestamp($t){
+ $this->timestamp = $t;
+ }
+
+ /**
+ * set query attribute of the object.
+ * @param $q the encoded query
+ */
+ public function setQuery($q){
+ $this->query = $q;
+ }
+
+ /**
+ * set author attribute of the object.
+ * @param $a integer id of the user who created the log entry
+ */
+ public function setAuthor($a){
+ $this->author = $a;
+ }
+
+ /**
+ * set ticket attribute of the object.
+ * @param $t integer id of ticket of which the log entry is related to.
+ */
+ public function setTicket($t){
+ $this->ticket = $t;
+ }
+
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_queue.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_queue.php
new file mode 100644
index 000000000..e72f1024d
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_queue.php
@@ -0,0 +1,139 @@
+query = "SELECT ticket . * FROM ticket LEFT JOIN assigned ON ticket.TId = assigned.Ticket WHERE assigned.Ticket IS NULL";
+ $this->params = array();
+ }
+
+ /**
+ * loads the 'all' tickets query into the objects attributes.
+ */
+ public function loadAllTickets(){
+ $this->query = "SELECT * FROM `ticket`";
+ $this->params = array();
+ }
+
+ /**
+ * loads the 'all open' tickets query into the objects attributes.
+ */
+ public function loadAllOpenTickets(){
+ $this->query = "SELECT * FROM ticket INNER JOIN ticket_user ON ticket.Author = ticket_user.TUserId and ticket.Status!=3";
+ $this->params = array();
+ }
+
+ /**
+ * loads the 'closed' tickets query into the objects attributes.
+ */
+ public function loadAllClosedTickets(){
+ $this->query = "SELECT * FROM ticket INNER JOIN ticket_user ON ticket.Author = ticket_user.TUserId and ticket.Status=3";
+ $this->params = array();
+ }
+
+ /**
+ * loads the 'todo' tickets query & params into the objects attributes.
+ * first: find the tickets assigned to the user with status = waiting on support,
+ * second find all not assigned tickets that aren't forwarded yet.
+ * find all tickets assigned to someone else witht status waiting on support, with timestamp of last reply > 1 day,
+ * find all non-assigned tickets forwarded to the support groups to which that user belongs
+ * @param $user_id the user's id to whom the tickets should be assigned
+ */
+ public function loadToDoTickets($user_id){
+
+ $this->query = "SELECT * FROM `ticket` t LEFT JOIN `assigned` a ON t.TId = a.Ticket LEFT JOIN `ticket_user` tu ON tu.TUserId = a.User LEFT JOIN `forwarded` f ON t.TId = f.Ticket
+ WHERE (tu.ExternId = :user_id AND t.Status = 1)
+ OR (a.Ticket IS NULL AND f.Group IS NULL)
+ OR (tu.ExternId != :user_id AND t.Status = 1 AND (SELECT ticket_reply.Timestamp FROM `ticket_reply` WHERE Ticket =t.TId ORDER BY TReplyId DESC LIMIT 1) < NOW() - INTERVAL 1 DAY )
+ OR (a.Ticket IS NULL AND EXISTS (SELECT * FROM `in_support_group` isg JOIN `ticket_user` tu2 ON isg.User = tu2.TUserId WHERE isg.Group = f.Group))
+ ";
+ $this->params = array('user_id' => $user_id);
+ }
+
+ /**
+ * loads the 'tickets asssigned to a user and waiting on support' query & params into the objects attributes.
+ * @param $user_id the user's id to whom the tickets should be assigned
+ */
+ public function loadAssignedandWaiting($user_id){
+ $this->query = "SELECT * FROM `ticket` t LEFT JOIN `assigned` a ON t.TId = a.Ticket LEFT JOIN `ticket_user` tu ON tu.TUserId = a.User
+ WHERE (tu.ExternId = :user_id AND t.Status = 1)";
+ $this->params = array('user_id' => $user_id);
+ }
+
+
+ /**
+ * loads the 'created' query & params into the objects attributes.
+ * This function creates dynamically a query based on the selected features.
+ * @param $who specifies if we want to user the user_id or group_id to form the query.
+ * @param $userid the user's id to whom the tickets should be assigned/not assigned
+ * @param $groupid the group's id to whom the tickets should be forwarded/not forwarded
+ * @param $what specifies what kind of tickets we want to return: waiting for support, waiting on user, closed
+ * @param $how specifies if the tickets should be or shouldn't be assigned/forwarded to the group/user selected.
+ */
+ public function createQueue($userid, $groupid, $what, $how, $who){
+
+ if($who == "user"){
+ $selectfrom = "SELECT * FROM `ticket` t LEFT JOIN `assigned` a ON t.TId = a.Ticket LEFT JOIN `ticket_user` tu ON tu.TUserId = a.User";
+ if ($how == "assigned"){
+ $assign = "tu.TUserId = :id" ;
+ }else if ($how == "not_assigned"){
+ $assign = "(tu.TUserId != :id OR a.Ticket IS NULL)";
+ }
+ }else if ($who == "support_group"){
+ $selectfrom = "SELECT * FROM `ticket` t LEFT JOIN `assigned` a ON t.TId = a.Ticket LEFT JOIN `ticket_user` tu ON tu.TUserId = a.User LEFT JOIN `forwarded` f ON t.TId = f.Ticket";
+ if ($how == "assigned"){
+ $assign = "f.Group = :id";
+ }else if ($how == "not_assigned"){
+ $assign = "(f.Group != :id OR f.Ticket IS NULL)" ;
+ }
+
+ }
+
+ if ($what == "waiting_for_support"){
+ $status = "t.Status = 1";
+ }else if ($what == "waiting_for_user"){
+ $status = "t.Status = 0";
+ }else if ($what == "closed"){
+ $status = "t.Status = 3";
+ }
+
+ $query = $selectfrom ." WHERE " . $assign;
+ if(isset($status)){
+ $query = $query . " AND " . $status;
+ }
+ if($who == "user"){
+ $params = array('id' => $userid);
+ }else if ($who == "support_group"){
+ $params = array('id' => $groupid);
+ }
+ $this->query = $query;
+ $this->params = $params;
+ }
+
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get query attribute of the object.
+ */
+ public function getQuery(){
+ return $this->query;
+ }
+
+ /**
+ * get params attribute of the object.
+ */
+ public function getParams(){
+ return $this->params;
+ }
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_queue_handler.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_queue_handler.php
new file mode 100644
index 000000000..5ea8d8781
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_queue_handler.php
@@ -0,0 +1,138 @@
+queue = new Ticket_Queue();
+ }
+
+ /**
+ * returns the tickets that are related in someway defined by $input.
+ * The $input parameter should be a string that defines what kind of queue should be loaded. A new pagination object will be instantiated and will load 10 entries,
+ * related to the $_GET['pagenum'] variable.
+ * @param $input identifier that defines what queue to load.
+ * @param $user_id the id of the user that browses the queues, some queues can be depending on this.
+ * @return an array consisting of ticket objects, beware, the author & category of a ticket, are objects on their own (no integers are used this time).
+ */
+ public function getTickets($input, $user_id){
+
+ switch ($input){
+ case "all":
+ $this->queue->loadAllTickets();
+ break;
+ case "all_open":
+ $this->queue->loadAllOpenTickets();
+ break;
+ case "archive":
+ $this->queue->loadAllClosedTickets();
+ break;
+ case "not_assigned":
+ $this->queue->loadAllNotAssignedTickets();
+ break;
+ case "todo":
+ $this->queue->loadToDoTickets($user_id);
+ break;
+ case "create":
+ //set these with the createQueue function proceding the getTickets function
+ break;
+ default:
+ return "ERROR";
+ }
+
+ $this->pagination = new Pagination($this->queue->getQuery(),"lib",10,"Ticket",$this->queue->getParams());
+ $elemArray = $this->pagination->getElements();
+ if(!empty($elemArray)){
+ foreach( $elemArray as $element ){
+ $catInstance = new Ticket_Category();
+ $catInstance->load_With_TCategoryId($element->getTicket_Category());
+ $element->setTicket_Category($catInstance);
+
+ $userInstance = new Ticket_User();
+ $userInstance->load_With_TUserId($element->getAuthor());
+ $element->setAuthor($userInstance);
+ }
+ }
+ return $this->pagination->getElements();
+
+ }
+
+
+ /**
+ * get pagination attribute of the object.
+ */
+ public function getPagination(){
+ return $this->pagination;
+ }
+
+ /**
+ * creates the queue.
+ * afterwards the getTickets function should be called, else a lot of extra parameters had to be added to the getTickets function..
+ */
+ public function createQueue($userid, $groupid, $what, $how, $who){
+ $this->queue->createQueue($userid, $groupid, $what, $how, $who);
+ }
+
+
+ ////////////////////////////////////////////Info retrievers about ticket statistics////////////////////////////////////////////////////
+
+ /**
+ * get the number of tickets in the todo queue for a specific user.
+ * @param $user_id the user being queried
+ */
+ public static function getNrOfTicketsToDo($user_id){
+ $queueHandler = new Ticket_Queue_Handler();
+ $queueHandler->queue->loadToDoTickets($user_id);
+ $query = $queueHandler->queue->getQuery();
+ $params = $queueHandler->queue->getParams();
+ $dbl = new DBLayer("lib");
+ return $dbl->execute($query,$params)->rowCount();
+ }
+
+ /**
+ * get the number of tickets assigned to a specific user and waiting for support.
+ * @param $user_id the user being queried
+ */
+ public static function getNrOfTicketsAssignedWaiting($user_id){
+ $queueHandler = new Ticket_Queue_Handler();
+ $queueHandler->queue->loadAssignedandWaiting($user_id);
+ $query = $queueHandler->queue->getQuery();
+ $params = $queueHandler->queue->getParams();
+ $dbl = new DBLayer("lib");
+ return $dbl->execute($query,$params)->rowCount();
+ }
+
+ /**
+ * get the total number of tickets.
+ */
+ public static function getNrOfTickets(){
+ $queueHandler = new Ticket_Queue_Handler();
+ $queueHandler->queue->loadAllTickets();
+ $query = $queueHandler->queue->getQuery();
+ $params = $queueHandler->queue->getParams();
+ $dbl = new DBLayer("lib");
+ return $dbl->execute($query,$params)->rowCount();
+ }
+
+ /**
+ * get the ticket object of the latest added ticket.
+ */
+ public static function getNewestTicket(){
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->executeWithoutParams("SELECT * FROM `ticket` ORDER BY `TId` DESC LIMIT 1 ");
+ $ticket = new Ticket();
+ $ticket->set($statement->fetch());
+ return $ticket;
+ }
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_reply.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_reply.php
new file mode 100644
index 000000000..8e784543d
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_reply.php
@@ -0,0 +1,252 @@
+setTReplyId($id);
+ return $instance;
+ }
+
+
+ /**
+ * return all replies on a specific ticket.
+ * @param $ticket_id the id of the ticket of which we want the replies.
+ * @param $view_as_admin if the browsing user is an admin/mod it should be 1, this will also show the hidden replies.
+ * @return an array with ticket_reply objects (beware the author and content are objects on their own, not integers!)
+ */
+ public static function getRepliesOfTicket( $ticket_id, $view_as_admin) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket_reply INNER JOIN ticket_content INNER JOIN ticket_user ON ticket_reply.Content = ticket_content.TContentId and ticket_reply.Ticket=:id and ticket_user.TUserId = ticket_reply.Author ORDER BY ticket_reply.TReplyId ASC", array('id' => $ticket_id));
+ $row = $statement->fetchAll();
+ $result = Array();
+ foreach($row as $tReply){
+ //only add hidden replies if the user is a mod/admin
+ if(! $tReply['Hidden'] || $view_as_admin){
+ //load author
+ $instanceAuthor = Ticket_User::constr_TUserId($tReply['Author']);
+ $instanceAuthor->setExternId($tReply['ExternId']);
+ $instanceAuthor->setPermission($tReply['Permission']);
+
+ //load content
+ $instanceContent = new Ticket_Content();
+ $instanceContent->setTContentId($tReply['TContentId']);
+ $instanceContent->setContent($tReply['Content']);
+
+ //load reply and add the author and content object in it.
+ $instanceReply = new self();
+ $instanceReply->setTReplyId($tReply['TReplyId']);
+ $instanceReply->setTimestamp($tReply['Timestamp']);
+ $instanceReply->setAuthor($instanceAuthor);
+ $instanceReply->setTicket($ticket_id);
+ $instanceReply->setContent($instanceContent);
+ $instanceReply->setHidden($tReply['Hidden']);
+ $result[] = $instanceReply;
+ }
+ }
+ return $result;
+ }
+
+ /**
+ * creates a new reply on a ticket.
+ * Creates a ticket_content entry and links it with a new created ticket_reply, a log entry will be written about this.
+ * In case the ticket creator replies on a ticket, he will set the status by default to 'waiting on support'.
+ * @param $content the content of the reply
+ * @param $author the id of the reply creator.
+ * @param $ticket_id the id of the ticket of which we want the replies.
+ * @param $hidden should be 0 or 1
+ * @param $ticket_creator the ticket's starter his id.
+ */
+ public static function createReply($content, $author, $ticket_id , $hidden, $ticket_creator){
+ $ticket_content = new Ticket_Content();
+ $ticket_content->setContent($content);
+ $ticket_content->create();
+ $content_id = $ticket_content->getTContentId();
+
+ $ticket_reply = new Ticket_Reply();
+ $ticket_reply->set(Array('Ticket' => $ticket_id,'Content' => $content_id,'Author' => $author, 'Hidden' => $hidden));
+ $ticket_reply->create();
+ $reply_id = $ticket_reply->getTReplyId();
+
+ if($ticket_creator == $author){
+ Ticket::updateTicketStatus( $ticket_id, 1, $author);
+ }
+
+ Ticket_Log::createLogEntry( $ticket_id, $author, 4, $reply_id);
+ }
+
+ ////////////////////////////////////////////Methods////////////////////////////////////////////////////
+
+ /**
+ * A constructor.
+ * Empty constructor
+ */
+ public function __construct() {
+ }
+
+
+ /**
+ * sets the object's attributes.
+ * @param $values should be an array.
+ */
+ public function set($values){
+ $this->setTicket($values['Ticket']);
+ $this->setContent($values['Content']);
+ $this->setAuthor($values['Author']);
+ if(isset($values['Timestamp'])){
+ $this->setTimestamp($values['Timestamp']);
+ }
+ if(isset($values['Hidden'])){
+ $this->setHidden($values['Hidden']);
+ }
+ }
+
+ /**
+ * creates a new 'ticket_reply' entry.
+ * this method will use the object's attributes for creating a new 'ticket_reply' entry in the database (the now() function will create the timestamp).
+ */
+ public function create(){
+ $dbl = new DBLayer("lib");
+ $query = "INSERT INTO ticket_reply (Ticket, Content, Author, Timestamp, Hidden) VALUES (:ticket, :content, :author, now(), :hidden)";
+ $values = Array('ticket' => $this->ticket, 'content' => $this->content, 'author' => $this->author, 'hidden' => $this->hidden);
+ $this->tReplyId = $dbl->executeReturnId($query, $values);
+ }
+
+ /**
+ * loads the object's attributes.
+ * loads the object's attributes by giving a ticket_reply's id.
+ * @param $id the id of the ticket_reply that should be loaded
+ */
+ public function load_With_TReplyId( $id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket_reply WHERE TReplyId=:id", array('id' => $id));
+ $row = $statement->fetch();
+ $this->tReplyId = $row['TReplyId'];
+ $this->ticket = $row['Ticket'];
+ $this->content = $row['Content'];
+ $this->author = $row['Author'];
+ $this->timestamp = $row['Timestamp'];
+ $this->hidden = $row['Hidden'];
+ }
+
+ /**
+ * updates a ticket_reply entry based on the objects attributes.
+ */
+ public function update(){
+ $dbl = new DBLayer("lib");
+ $query = "UPDATE ticket SET Ticket = :ticket, Content = :content, Author = :author, Timestamp = :timestamp, Hidden = :hidden WHERE TReplyId=:id";
+ $values = Array('id' => $this->tReplyId, 'timestamp' => $this->timestamp, 'ticket' => $this->ticket, 'content' => $this->content, 'author' => $this->author, 'hidden' => $this->hidden);
+ $statement = $dbl->execute($query, $values);
+ }
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get ticket attribute of the object.
+ */
+ public function getTicket(){
+ return $this->ticket;
+ }
+
+ /**
+ * get content attribute of the object.
+ */
+ public function getContent(){
+ return $this->content;
+ }
+
+ /**
+ * get author attribute of the object.
+ */
+ public function getAuthor(){
+ return $this->author;
+ }
+
+ /**
+ * get timestamp attribute of the object.
+ * The output format is defined by the Helpers class function, outputTime().
+ */
+ public function getTimestamp(){
+ return Helpers::outputTime($this->timestamp);
+ }
+
+ /**
+ * get tReplyId attribute of the object.
+ */
+ public function getTReplyId(){
+ return $this->tReplyId;
+ }
+
+ /**
+ * get hidden attribute of the object.
+ */
+ public function getHidden(){
+ return $this->hidden;
+ }
+
+ ////////////////////////////////////////////Setters////////////////////////////////////////////////////
+
+ /**
+ * set ticket attribute of the object.
+ * @param $t integer id of the ticket
+ */
+ public function setTicket($t){
+ $this->ticket = $t;
+ }
+
+ /**
+ * set content attribute of the object.
+ * @param $c integer id of the ticket_content entry
+ */
+ public function setContent($c){
+ $this->content = $c;
+ }
+
+ /**
+ * set author attribute of the object.
+ * @param $a integer id of the user
+ */
+ public function setAuthor($a){
+ $this->author = $a;
+ }
+
+ /**
+ * set timestamp attribute of the object.
+ * @param $t timestamp of the reply
+ */
+ public function setTimestamp($t){
+ $this->timestamp = $t;
+ }
+
+ /**
+ * set tReplyId attribute of the object.
+ * @param $i integer id of the ticket_reply
+ */
+ public function setTReplyId($i){
+ $this->tReplyId = $i;
+ }
+
+ /**
+ * set hidden attribute of the object.
+ * @param $h should be 0 or 1
+ */
+ public function setHidden($h){
+ $this->hidden = $h;
+ }
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_user.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_user.php
new file mode 100644
index 000000000..46125e284
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/ticket_user.php
@@ -0,0 +1,269 @@
+ $permission, 'ext_id' => $extern_id);
+ $dbl->execute($query, $values);
+
+ }
+
+
+ /**
+ * check if a ticket_user object is a mod or not.
+ * @param $user the ticket_user object itself
+ * @return true or false
+ */
+ public static function isMod($user){
+ if(isset($user) && $user->getPermission() > 1){
+ return true;
+ }
+ return false;
+ }
+
+
+ /**
+ * check if a ticket_user object is an admin or not.
+ * @param $user the ticket_user object itself
+ * @return true or false
+ */
+ public static function isAdmin($user){
+ if(isset($user) && $user->getPermission() == 3){
+ return true;
+ }
+ return false;
+ }
+
+
+ /**
+ * return constructed ticket_user object based on TUserId.
+ * @param $id the TUserId of the entry.
+ * @return constructed ticket_user object
+ */
+ public static function constr_TUserId( $id) {
+ $instance = new self();
+ $instance->setTUserId($id);
+ return $instance;
+
+ }
+
+
+ /**
+ * return a list of all mods/admins.
+ * @return an array consisting of ticket_user objects that are mods & admins.
+ */
+ public static function getModsAndAdmins() {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->executeWithoutParams("SELECT * FROM `ticket_user` WHERE `Permission` > 1");
+ $rows = $statement->fetchAll();
+ $result = Array();
+ foreach($rows as $user){
+ $instanceUser = new self();
+ $instanceUser->set($user);
+ $result[] = $instanceUser;
+ }
+ return $result;
+ }
+
+
+ /**
+ * return constructed ticket_user object based on ExternId.
+ * @param $id the ExternId of the entry.
+ * @return constructed ticket_user object
+ */
+ public static function constr_ExternId( $id) {
+ $instance = new self();
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket_user WHERE ExternId=:id", array('id' => $id));
+ $row = $statement->fetch();
+ $instance->tUserId = $row['TUserId'];
+ $instance->permission = $row['Permission'];
+ $instance->externId = $row['ExternId'];
+ return $instance;
+ }
+
+
+ /**
+ * change the permission of a ticket_user.
+ * @param $user_id the TUserId of the entry.
+ * @param $perm the new permission value.
+ */
+ public static function change_permission($user_id, $perm){
+ $user = new Ticket_User();
+ $user->load_With_TUserId($user_id);
+ $user->setPermission($perm);
+ $user->update();
+ }
+
+
+ /**
+ * return the email address of a ticket_user.
+ * @param $id the TUserId of the entry.
+ * @return string containing the email address of that user.
+ */
+ public static function get_email_by_user_id($id){
+ $user = new Ticket_User();
+ $user->load_With_TUserId($id);
+ $webUser = new WebUsers($user->getExternId());
+ return $webUser->getEmail();
+ }
+
+
+ /**
+ * return the username of a ticket_user.
+ * @param $id the TUserId of the entry.
+ * @return string containing username of that user.
+ */
+ public static function get_username_from_id($id){
+ $user = new Ticket_User();
+ $user->load_With_TUserId($id);
+ $webUser = new WebUsers($user->getExternId());
+ return $webUser->getUsername();
+ }
+
+
+ /**
+ * return the TUserId of a ticket_user by giving a username.
+ * @param $username the username of a user.
+ * @return the TUserId related to that username.
+ */
+ public static function get_id_from_username($username){
+ $externId = WebUsers::getId($username);
+ $user = Ticket_User::constr_ExternId($externId);
+ return $user->getTUserId();
+ }
+
+ /**
+ * return the ticket_user id from an email address.
+ * @param $email the emailaddress of a user.
+ * @return the ticket_user id related to that email address, in case none, return "FALSE".
+ */
+ public static function get_id_from_email($email){
+ $webUserId = WebUsers::getIdFromEmail($email);
+ if($webUserId != "FALSE"){
+ $user = Ticket_User::constr_ExternId($webUserId);
+ return $user->getTUserId();
+ }else{
+ return "FALSE";
+ }
+ }
+
+
+ ////////////////////////////////////////////Methods////////////////////////////////////////////////////
+
+ /**
+ * A constructor.
+ * Empty constructor
+ */
+ public function __construct() {
+ }
+
+
+ /**
+ * sets the object's attributes.
+ * @param $values should be an array of the form array('TUserId' => id, 'Permission' => perm, 'ExternId' => ext_id).
+ */
+ public function set($values) {
+ $this->setTUserId($values['TUserId']);
+ $this->setPermission($values['Permission']);
+ $this->setExternId($values['ExternId']);
+ }
+
+
+ /**
+ * loads the object's attributes.
+ * loads the object's attributes by giving a TUserId.
+ * @param $id the id of the ticket_user that should be loaded
+ */
+ public function load_With_TUserId( $id) {
+ $dbl = new DBLayer("lib");
+ $statement = $dbl->execute("SELECT * FROM ticket_user WHERE TUserId=:id", array('id' => $id));
+ $row = $statement->fetch();
+ $this->tUserId = $row['TUserId'];
+ $this->permission = $row['Permission'];
+ $this->externId = $row['ExternId'];
+ }
+
+
+ /**
+ * update the object's attributes to the db.
+ */
+ public function update(){
+ $dbl = new DBLayer("lib");
+ $query = "UPDATE ticket_user SET Permission = :perm, ExternId = :ext_id WHERE TUserId=:id";
+ $values = Array('id' => $this->tUserId, 'perm' => $this->permission, 'ext_id' => $this->externId);
+ $statement = $dbl->execute($query, $values);
+ }
+
+ ////////////////////////////////////////////Getters////////////////////////////////////////////////////
+
+ /**
+ * get permission attribute of the object.
+ */
+ public function getPermission(){
+ return $this->permission;
+ }
+
+ /**
+ * get externId attribute of the object.
+ */
+ public function getExternId(){
+ return $this->externId;
+ }
+
+ /**
+ * get tUserId attribute of the object.
+ */
+ public function getTUserId(){
+ return $this->tUserId;
+ }
+
+
+ ////////////////////////////////////////////Setters////////////////////////////////////////////////////
+
+ /**
+ * set permission attribute of the object.
+ * @param $perm integer that indicates the permission level. (1= user, 2= mod, 3= admin)
+ */
+ public function setPermission($perm){
+ $this->permission = $perm;
+ }
+
+
+ /**
+ * set externId attribute of the object.
+ * @param $id the external id.
+ */
+ public function setExternId($id){
+ $this->externId = $id;
+ }
+
+ /**
+ * set tUserId attribute of the object.
+ * @param $id the ticket_user id
+ */
+ public function setTUserId($id){
+ $this->tUserId= $id;
+ }
+
+
+}
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/users.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/users.php
new file mode 100644
index 000000000..7dbb1bfda
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/autoload/users.php
@@ -0,0 +1,472 @@
+ $GAME_NAME,
+ // 'WELCOME_MESSAGE' => $WELCOME_MESSAGE,
+ 'USERNAME' => $user,
+ 'PASSWORD' => $pass,
+ 'CPASSWORD' => $cpass,
+ 'EMAIL' => $email
+ );
+ if ( $user != "success" ){
+ $pageElements['USERNAME_ERROR'] = 'TRUE';
+ }else{
+ $pageElements['USERNAME_ERROR'] = 'FALSE';
+ }
+
+ if ( $pass != "success" ){
+ $pageElements['PASSWORD_ERROR'] = 'TRUE';
+ }else{
+ $pageElements['PASSWORD_ERROR'] = 'FALSE';
+ }
+ if ( $cpass != "success" ){
+ $pageElements['CPASSWORD_ERROR'] = 'TRUE';
+ }else{
+ $pageElements['CPASSWORD_ERROR'] = 'FALSE';
+ }
+ if ( $email != "success" ){
+ $pageElements['EMAIL_ERROR'] = 'TRUE';
+ }else{
+ $pageElements['EMAIL_ERROR'] = 'FALSE';
+ }
+ if ( isset( $_POST["TaC"] ) ){
+ $pageElements['TAC_ERROR'] = 'FALSE';
+ }else{
+ $pageElements['TAC_ERROR'] = 'TRUE';
+ }
+ return $pageElements;
+ }
+
+ }
+
+
+ /**
+ * checks if entered username is valid.
+ * @param $username the username that the user wants to use.
+ * @return string Info: Returns a string based on if the username is valid, if valid then "success" is returned
+ */
+ public function checkUser( $username )
+ {
+ if ( isset( $username ) ){
+ if ( strlen( $username ) > 12 ){
+ return "Username must be no more than 12 characters.";
+ }else if ( strlen( $username ) < 5 ){
+ return "Username must be 5 or more characters.";
+ }else if ( !preg_match( '/^[a-z0-9\.]*$/', $username ) ){
+ return "Username can only contain numbers and letters.";
+ }else if ( $username == "" ){
+ return "You have to fill in a username";
+ }elseif ($this->checkUserNameExists($username)){
+ return "Username " . $username . " is in use.";
+ }else{
+ return "success";
+ }
+ }
+ return "fail";
+ }
+
+ /**
+ * check if username already exists.
+ * This is the base function, it should be overwritten by the WebUsers class.
+ * @param $username the username
+ * @return string Info: Returns true or false if the user is in the www db.
+ */
+ protected function checkUserNameExists($username){
+ //You should overwrite this method with your own version!
+ print('this is the base class!');
+
+ }
+
+
+ /**
+ * checks if the password is valid.
+ * @param $pass the password willing to be used.
+ * @return string Info: Returns a string based on if the password is valid, if valid then "success" is returned
+ */
+ public function checkPassword( $pass )
+ {
+ if ( isset( $pass ) ){
+ if ( strlen( $pass ) > 20 ){
+ return "Password must be no more than 20 characters.";
+ }elseif ( strlen( $pass ) < 5 ){
+ return "Password must be more than 5 characters.";
+ }elseif ( $pass == ""){
+ return "You have to fill in a password";
+ }else{
+ return "success";
+ }
+ }
+ return "fail";
+ }
+
+
+ /**
+ * checks if the confirmPassword matches the original.
+ * @param $pass_result the result of the previous password check.
+ * @param $pass the original pass.
+ * @param $confirmpass the confirmation password.
+ * @return string Info: Verify's $_POST["Password"] is the same as $_POST["ConfirmPass"]
+ */
+ private function confirmPassword($pass_result,$pass,$confirmpass)
+ {
+ if ($confirmpass==""){
+ return "You have to fill in the confirmation password.";
+ }
+ else if ( ( $pass ) != ( $confirmpass ) ){
+ return "Passwords do not match.";
+ }else if($pass_result != "success"){
+ return;
+ }else{
+ return "success";
+ }
+ return "fail";
+ }
+
+
+ /**
+ * wrapper to check if the email address is valid.
+ * @param $email the email address
+ * @return "success", else in case it isn't valid an error will be returned.
+ */
+ public function checkEmail( $email )
+ {
+ if ( isset( $email ) ){
+ if ( !Users::validEmail( $email ) ){
+ return "Email address is not valid.";
+ }else if($email == ""){
+ return "You have to fill in an email address";
+ }else if ($this->checkEmailExists($email)){
+ return "Email is in use.";
+ }else{
+ return "success";
+ }
+ }
+ return "fail";
+ }
+
+
+ /**
+ * check if email already exists.
+ * This is the base function, it should be overwritten by the WebUsers class.
+ * @param $email the email address
+ * @return string Info: Returns true or false if the email is in the www db.
+ */
+ protected function checkEmailExists($email){
+ //TODO: You should overwrite this method with your own version!
+ print('this is the base class!');
+
+ }
+
+
+ /**
+ * check if the emailaddress structure is valid.
+ * @param $email the email address
+ * @return true or false
+ */
+ public function validEmail( $email ){
+ $isValid = true;
+ $atIndex = strrpos( $email, "@" );
+ if ( is_bool( $atIndex ) && !$atIndex ){
+ $isValid = false;
+ }else{
+ $domain = substr( $email, $atIndex + 1 );
+ $local = substr( $email, 0, $atIndex );
+ $localLen = strlen( $local );
+ $domainLen = strlen( $domain );
+ if ( $localLen < 1 || $localLen > 64 ){
+ // local part length exceeded
+ $isValid = false;
+ }else if ( $domainLen < 1 || $domainLen > 255 ){
+ // domain part length exceeded
+ $isValid = false;
+ }else if ( $local[0] == '.' || $local[$localLen - 1] == '.' ){
+ // local part starts or ends with '.'
+ $isValid = false;
+ }else if ( preg_match( '/\\.\\./', $local ) ){
+ // local part has two consecutive dots
+ $isValid = false;
+ }else if ( !preg_match( '/^[A-Za-z0-9\\-\\.]+$/', $domain ) ){
+ // character not valid in domain part
+ $isValid = false;
+ }else if ( preg_match( '/\\.\\./', $domain ) ){
+ // domain part has two consecutive dots
+ $isValid = false;
+ }else if ( !preg_match( '/^(\\\\.|[A-Za-z0-9!#%&`_=\\/$\'*+?^{}|~.-])+$/', str_replace( "\\\\", "", $local ) ) ){
+ // character not valid in local part unless
+ // local part is quoted
+ if ( !preg_match( '/^"(\\\\"|[^"])+"$/', str_replace( "\\\\", "", $local ) ) ){
+ $isValid = false;
+ }
+ }
+ if ( $isValid && !( checkdnsrr( $domain, "MX" ) || checkdnsrr( $domain, "A" ) ) ){
+ // domain not found in DNS
+ $isValid = false;
+ }
+ }
+ return $isValid;
+ }
+
+
+
+ /**
+ * generate a SALT.
+ * @param $length the length of the SALT which is by default 2
+ * @return a random salt of 2 chars
+ */
+ public static function generateSALT( $length = 2 )
+ {
+ // start with a blank salt
+ $salt = "";
+ // define possible characters - any character in this string can be
+ // picked for use in the salt, so if you want to put vowels back in
+ // or add special characters such as exclamation marks, this is where
+ // you should do it
+ $possible = "2346789bcdfghjkmnpqrtvwxyzBCDFGHJKLMNPQRTVWXYZ";
+ // we refer to the length of $possible a few times, so let's grab it now
+ $maxlength = strlen( $possible );
+ // check for length overflow and truncate if necessary
+ if ( $length > $maxlength ){
+ $length = $maxlength;
+ }
+ // set up a counter for how many characters are in the salt so far
+ $i = 0;
+ // add random characters to $salt until $length is reached
+ while ( $i < $length ){
+ // pick a random character from the possible ones
+ $char = substr( $possible, mt_rand( 0, $maxlength - 1 ), 1 );
+ // have we already used this character in $salt?
+ if ( !strstr( $salt, $char ) ){
+ // no, so it's OK to add it onto the end of whatever we've already got...
+ $salt .= $char;
+ // ... and increase the counter by one
+ $i++;
+ }
+ }
+ // done!
+ return $salt;
+ }
+
+
+
+ /**
+ * creates a user in the shard.
+ * incase the shard is offline it will place it in the ams_querycache. You have to create a user first in the CMS/WWW and use the id for this function.
+ * @param $values with name,pass and mail
+ * @param $user_id the extern id of the user (the id given by the www/CMS)
+ * @return ok if it's get correctly added to the shard, else return lib offline and put in libDB, if libDB is also offline return liboffline.
+ */
+ public static function createUser($values, $user_id){
+ try {
+ //make connection with and put into shard db
+ $dbs = new DBLayer("shard");
+ $dbs->execute("INSERT INTO user (Login, Password, Email) VALUES (:name, :pass, :mail)",$values);
+ ticket_user::createTicketUser( $user_id, 1);
+ return "ok";
+ }
+ catch (PDOException $e) {
+ //oh noooz, the shard is offline! Put in query queue at ams_lib db!
+ try {
+ $dbl = new DBLayer("lib");
+ $dbl->execute("INSERT INTO ams_querycache (type, query, db) VALUES (:type, :query, :db)",array("type" => "createUser",
+ "query" => json_encode(array($values["name"],$values["pass"],$values["mail"])), "db" => "shard"));
+ ticket_user::createTicketUser( $user_id , 1 );
+ return "shardoffline";
+ }catch (PDOException $e) {
+ print_r($e);
+ return "liboffline";
+ }
+ }
+
+ }
+
+ /**
+ * creates permissions in the shard db for a user.
+ * incase the shard is offline it will place it in the ams_querycache.
+ * @param $pvalues with username
+ */
+ public static function createPermissions($pvalues) {
+
+ try {
+ $values = array('username' => $pvalues[0]);
+ $dbs = new DBLayer("shard");
+ $sth = $dbs->execute("SELECT UId FROM user WHERE Login= :username;", $values);
+ $result = $sth->fetchAll();
+ foreach ($result as $UId) {
+ $ins_values = array('id' => $UId['UId']);
+ $dbs->execute("INSERT INTO permission (UId, ClientApplication, AccessPrivilege) VALUES (:id, 'r2', 'OPEN');", $ins_values);
+ $dbs->execute("INSERT INTO permission (UId, ClientApplication, AccessPrivilege) VALUES (:id , 'ryzom_open', 'OPEN');", $ins_values);
+ }
+ }
+ catch (PDOException $e) {
+ //oh noooz, the shard is offline! Put it in query queue at ams_lib db!
+ $dbl = new DBLayer("lib");
+ $dbl->execute("INSERT INTO ams_querycache (type, query, db) VALUES (:type, :query, :db)",array("type" => "createPermissions",
+ "query" => json_encode(array($pvalues[0])), "db" => "shard"));
+
+
+ }
+ return true;
+ }
+
+
+ /**
+ * check if username and password matches.
+ * This is the base function, it should be overwritten by the WebUsers class.
+ * @param $user the inserted username
+ * @param $pass the inserted password
+ */
+ protected function checkLoginMatch($user,$pass){
+ print('This is the base class!');
+ }
+
+ /**
+ * check if the changing of a password is valid.
+ * a mod/admin doesn't has to fill in the previous password when he wants to change the password, however for changing his own password he has to fill it in.
+ * @param $values an array containing the CurrentPass, ConfirmNewPass, NewPass and adminChangesOthers
+ * @return if it is valid "success will be returned, else an array with errors will be returned.
+ */
+ public function check_change_password($values){
+ //if admin isn't changing others
+ if(!$values['adminChangesOther']){
+ if ( isset( $values["user"] ) and isset( $values["CurrentPass"] ) and isset( $values["ConfirmNewPass"] ) and isset( $values["NewPass"] ) ){
+ $match = $this->checkLoginMatch($values["user"],$values["CurrentPass"]);
+ $newpass = $this->checkPassword($values["NewPass"]);
+ $confpass = $this->confirmPassword($newpass,$values["NewPass"],$values["ConfirmNewPass"]);
+ }else{
+ $match = "";
+ $newpass = "";
+ $confpass = "";
+ }
+ }else{
+ //if admin is indeed changing someone!
+ if ( isset( $values["user"] ) and isset( $values["ConfirmNewPass"] ) and isset( $values["NewPass"] ) ){
+ $newpass = $this->checkPassword($values["NewPass"]);
+ $confpass = $this->confirmPassword($newpass,$values["NewPass"],$values["ConfirmNewPass"]);
+ }else{
+ $newpass = "";
+ $confpass = "";
+ }
+ }
+ if ( !$values['adminChangesOther'] and ( $match != "fail" ) and ( $newpass == "success" ) and ( $confpass == "success" ) ){
+ return "success";
+ }else if($values['adminChangesOther'] and ( $newpass == "success" ) and ( $confpass == "success" ) ){
+ return "success";
+ }else{
+ $pageElements = array(
+ 'newpass_error_message' => $newpass,
+ 'confirmnewpass_error_message' => $confpass
+ );
+ if(!$values['adminChangesOther']){
+ $pageElements['match_error_message'] = $match;
+ if ( $match != "fail" ){
+ $pageElements['MATCH_ERROR'] = 'FALSE';
+ }else{
+ $pageElements['MATCH_ERROR'] = 'TRUE';
+ }
+ }
+ if ( $newpass != "success" ){
+ $pageElements['NEWPASSWORD_ERROR'] = 'TRUE';
+ }else{
+ $pageElements['NEWPASSWORD_ERROR'] = 'FALSE';
+ }
+ if ( $confpass != "success" ){
+ $pageElements['CNEWPASSWORD_ERROR'] = 'TRUE';
+ }else{
+ $pageElements['CNEWPASSWORD_ERROR'] = 'FALSE';
+ }
+ return $pageElements;
+ }
+ }
+
+ /**
+ * sets the shards password.
+ * in case the shard is offline, the entry will be stored in the ams_querycache.
+ * @param $user the usersname of the account of which we want to change the password.
+ * @param $pass the new password.
+ * @return ok if it worked, if the lib or shard is offline it will return liboffline or shardoffline.
+ */
+ protected function setAmsPassword($user, $pass){
+
+ $values = Array('user' => $user, 'pass' => $pass);
+
+ try {
+ //make connection with and put into shard db
+ $dbs = new DBLayer("shard");
+ $dbs->execute("UPDATE user SET Password = :pass WHERE Login = :user ",$values);
+ return "ok";
+ }
+ catch (PDOException $e) {
+ //oh noooz, the shard is offline! Put in query queue at ams_lib db!
+ try {
+ $dbl = new DBLayer("lib");
+ $dbl->execute("INSERT INTO ams_querycache (type, query, db) VALUES (:type, :query, :db)",array("type" => "change_pass",
+ "query" => json_encode(array($values["user"],$values["pass"])), "db" => "shard"));
+ return "shardoffline";
+ }catch (PDOException $e) {
+ return "liboffline";
+ }
+ }
+ }
+
+ /**
+ * sets the shards email.
+ * in case the shard is offline, the entry will be stored in the ams_querycache.
+ * @param $user the usersname of the account of which we want to change the emailaddress.
+ * @param $mail the new email address
+ * @return ok if it worked, if the lib or shard is offline it will return liboffline or shardoffline.
+ */
+ protected function setAmsEmail($user, $mail){
+
+ $values = Array('user' => $user, 'mail' => $mail);
+
+ try {
+ //make connection with and put into shard db
+ $dbs = new DBLayer("shard");
+ $dbs->execute("UPDATE user SET Email = :mail WHERE Login = :user ",$values);
+ return "ok";
+ }
+ catch (PDOException $e) {
+ //oh noooz, the shard is offline! Put in query queue at ams_lib db!
+ try {
+ $dbl = new DBLayer("lib");
+ $dbl->execute("INSERT INTO ams_querycache (type, query, db) VALUES (:type, :query, :db)",array("type" => "change_mail",
+ "query" => json_encode(array($values["user"],$values["mail"])), "db" => "shard"));
+ return "shardoffline";
+ }catch (PDOException $e) {
+ return "liboffline";
+ }
+ }
+ }
+}
+
+
+
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/configs/ams_lib.conf b/code/ryzom/tools/server/ryzom_ams/ams_lib/configs/ams_lib.conf
new file mode 100644
index 000000000..b9e919045
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/configs/ams_lib.conf
@@ -0,0 +1,3 @@
+title = Welcome to Smarty!
+cutoff_size = 40
+
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/configs/ingame_layout.ini b/code/ryzom/tools/server/ryzom_ams/ams_lib/configs/ingame_layout.ini
new file mode 100644
index 000000000..f19d43265
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/configs/ingame_layout.ini
@@ -0,0 +1,47 @@
+; This is the ingame layout config file
+; Here you can easily change colors of specific elements in the ingame templates.
+
+;-------------------------------------------------------------------------------
+
+[basic]
+
+;second menu bar bg color
+second_menu_bg_color = "#00000040"
+
+;title bg color
+title_bg_color = "#303030"
+
+;default info text color
+info_color = "#00CED1"
+
+;notification color
+notification_color = "red"
+
+;Account (user/admin/mod) name color
+team_color = "red"
+user_color = "green"
+mod_color = "orange"
+admin_color = "red"
+
+;main table bg color
+main_tbl_color = "#00000030"
+
+;normal table bg color
+normal_tbl_color = "#00000060"
+
+;table bg color for team replies
+team_reply_tbl_color = "#F8C8C140"
+
+;table bg color for hidden replies
+hidden_reply_tbl_color = "#CFFEFF40"
+
+;table bg color for closed reply
+closed_tbl_color = "#FFE69960"
+
+;table header tr bg color
+table_header_tr_color = "#00000090"
+
+;pagination current page bg
+pagination_current_page_bg = "#00CED190"
+
+;-------------------------------------------------------------------------------
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/cron/mail_cron.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/cron/mail_cron.php
new file mode 100644
index 000000000..557a57417
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/cron/mail_cron.php
@@ -0,0 +1,12 @@
+cron();
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/cron/sync_cron.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/cron/sync_cron.php
new file mode 100644
index 000000000..b39da0818
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/cron/sync_cron.php
@@ -0,0 +1,11 @@
+
+
+{* bold and title are read from the config file *}
+{if #bold#}{/if}
+{* capitalize the first letters of each word of the title *}
+Title: {#title#|capitalize}
+{if #bold#}{/if}
+
+The current date and time is {$smarty.now|date_format:"%Y-%m-%d %H:%M:%S"}
+
+The value of global assigned variable $SCRIPT_NAME is {$SCRIPT_NAME}
+
+Example of accessing server environment variable SERVER_NAME: {$smarty.server.SERVER_NAME}
+
+The value of {ldelim}$Name{rdelim} is {$Name}
+
+variable modifier example of {ldelim}$Name|upper{rdelim}
+
+{$Name|upper}
+
+
+An example of a section loop:
+
+{section name=outer
+loop=$FirstName}
+{if $smarty.section.outer.index is odd by 2}
+ {$smarty.section.outer.rownum} . {$FirstName[outer]} {$LastName[outer]}
+{else}
+ {$smarty.section.outer.rownum} * {$FirstName[outer]} {$LastName[outer]}
+{/if}
+{sectionelse}
+ none
+{/section}
+
+An example of section looped key values:
+
+{section name=sec1 loop=$contacts}
+ phone: {$contacts[sec1].phone}
+ fax: {$contacts[sec1].fax}
+ cell: {$contacts[sec1].cell}
+{/section}
+
+{/strip}
+
+
+
+This is an example of the html_select_date function:
+
+
+
+This is an example of the html_select_time function:
+
+
+
+This is an example of the html_options function:
+
+
+
+{include file="footer.tpl"}
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/ingame_templates/layout.tpl b/code/ryzom/tools/server/ryzom_ams/ams_lib/ingame_templates/layout.tpl
new file mode 100644
index 000000000..c98768e52
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/ingame_templates/layout.tpl
@@ -0,0 +1,34 @@
+
+
+
+
+ Ryzom Account Management System
+
+
+
+
+
+
+
+ *
+ * @package Resource-examples
+ * @author Rodney Rehm
+ */
+class Smarty_Resource_Mysqls extends Smarty_Resource_Custom {
+ // PDO instance
+ protected $db;
+ // prepared fetch() statement
+ protected $fetch;
+
+ public function __construct() {
+ try {
+ $this->db = new PDO("mysql:dbname=test;host=127.0.0.1", "smarty", "smarty");
+ } catch (PDOException $e) {
+ throw new SmartyException('Mysql Resource failed: ' . $e->getMessage());
+ }
+ $this->fetch = $this->db->prepare('SELECT modified, source FROM templates WHERE name = :name');
+ }
+
+ /**
+ * Fetch a template and its modification time from database
+ *
+ * @param string $name template name
+ * @param string $source template source
+ * @param integer $mtime template modification timestamp (epoch)
+ * @return void
+ */
+ protected function fetch($name, &$source, &$mtime)
+ {
+ $this->fetch->execute(array('name' => $name));
+ $row = $this->fetch->fetch();
+ $this->fetch->closeCursor();
+ if ($row) {
+ $source = $row['source'];
+ $mtime = strtotime($row['modified']);
+ } else {
+ $source = null;
+ $mtime = null;
+ }
+ }
+}
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/README b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/README
new file mode 100644
index 000000000..bf03403aa
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/README
@@ -0,0 +1,574 @@
+Smarty 3.1.13
+
+Author: Monte Ohrt
+Author: Uwe Tews
+
+AN INTRODUCTION TO SMARTY 3
+
+NOTICE FOR 3.1 release:
+
+Please see the SMARTY_3.1_NOTES.txt file that comes with the distribution.
+
+NOTICE for 3.0.5 release:
+
+Smarty now follows the PHP error_reporting level by default. If PHP does not mask E_NOTICE and you try to access an unset template variable, you will now get an E_NOTICE warning. To revert to the old behavior:
+
+$smarty->error_reporting = E_ALL & ~E_NOTICE;
+
+NOTICE for 3.0 release:
+
+IMPORTANT: Some API adjustments have been made between the RC4 and 3.0 release.
+We felt it is better to make these now instead of after a 3.0 release, then have to
+immediately deprecate APIs in 3.1. Online documentation has been updated
+to reflect these changes. Specifically:
+
+---- API CHANGES RC4 -> 3.0 ----
+
+$smarty->register->*
+$smarty->unregister->*
+$smarty->utility->*
+$samrty->cache->*
+
+Have all been changed to local method calls such as:
+
+$smarty->clearAllCache()
+$smarty->registerFoo()
+$smarty->unregisterFoo()
+$smarty->testInstall()
+etc.
+
+Registration of function, block, compiler, and modifier plugins have been
+consolidated under two API calls:
+
+$smarty->registerPlugin(...)
+$smarty->unregisterPlugin(...)
+
+Registration of pre, post, output and variable filters have been
+consolidated under two API calls:
+
+$smarty->registerFilter(...)
+$smarty->unregisterFilter(...)
+
+Please refer to the online documentation for all specific changes:
+
+http://www.smarty.net/documentation
+
+----
+
+The Smarty 3 API has been refactored to a syntax geared
+for consistency and modularity. The Smarty 2 API syntax is still supported, but
+will throw a deprecation notice. You can disable the notices, but it is highly
+recommended to adjust your syntax to Smarty 3, as the Smarty 2 syntax must run
+through an extra rerouting wrapper.
+
+Basically, all Smarty methods now follow the "fooBarBaz" camel case syntax. Also,
+all Smarty properties now have getters and setters. So for example, the property
+$smarty->cache_dir can be set with $smarty->setCacheDir('foo/') and can be
+retrieved with $smarty->getCacheDir().
+
+Some of the Smarty 3 APIs have been revoked such as the "is*" methods that were
+just duplicate functions of the now available "get*" methods.
+
+Here is a rundown of the Smarty 3 API:
+
+$smarty->fetch($template, $cache_id = null, $compile_id = null, $parent = null)
+$smarty->display($template, $cache_id = null, $compile_id = null, $parent = null)
+$smarty->isCached($template, $cache_id = null, $compile_id = null)
+$smarty->createData($parent = null)
+$smarty->createTemplate($template, $cache_id = null, $compile_id = null, $parent = null)
+$smarty->enableSecurity()
+$smarty->disableSecurity()
+$smarty->setTemplateDir($template_dir)
+$smarty->addTemplateDir($template_dir)
+$smarty->templateExists($resource_name)
+$smarty->loadPlugin($plugin_name, $check = true)
+$smarty->loadFilter($type, $name)
+$smarty->setExceptionHandler($handler)
+$smarty->addPluginsDir($plugins_dir)
+$smarty->getGlobal($varname = null)
+$smarty->getRegisteredObject($name)
+$smarty->getDebugTemplate()
+$smarty->setDebugTemplate($tpl_name)
+$smarty->assign($tpl_var, $value = null, $nocache = false)
+$smarty->assignGlobal($varname, $value = null, $nocache = false)
+$smarty->assignByRef($tpl_var, &$value, $nocache = false)
+$smarty->append($tpl_var, $value = null, $merge = false, $nocache = false)
+$smarty->appendByRef($tpl_var, &$value, $merge = false)
+$smarty->clearAssign($tpl_var)
+$smarty->clearAllAssign()
+$smarty->configLoad($config_file, $sections = null)
+$smarty->getVariable($variable, $_ptr = null, $search_parents = true, $error_enable = true)
+$smarty->getConfigVariable($variable)
+$smarty->getStreamVariable($variable)
+$smarty->getConfigVars($varname = null)
+$smarty->clearConfig($varname = null)
+$smarty->getTemplateVars($varname = null, $_ptr = null, $search_parents = true)
+$smarty->clearAllCache($exp_time = null, $type = null)
+$smarty->clearCache($template_name, $cache_id = null, $compile_id = null, $exp_time = null, $type = null)
+
+$smarty->registerPlugin($type, $tag, $callback, $cacheable = true, $cache_attr = array())
+
+$smarty->registerObject($object_name, $object_impl, $allowed = array(), $smarty_args = true, $block_methods = array())
+
+$smarty->registerFilter($type, $function_name)
+$smarty->registerResource($resource_type, $function_names)
+$smarty->registerDefaultPluginHandler($function_name)
+$smarty->registerDefaultTemplateHandler($function_name)
+
+$smarty->unregisterPlugin($type, $tag)
+$smarty->unregisterObject($object_name)
+$smarty->unregisterFilter($type, $function_name)
+$smarty->unregisterResource($resource_type)
+
+$smarty->compileAllTemplates($extention = '.tpl', $force_compile = false, $time_limit = 0, $max_errors = null)
+$smarty->clearCompiledTemplate($resource_name = null, $compile_id = null, $exp_time = null)
+$smarty->testInstall()
+
+// then all the getters/setters, available for all properties. Here are a few:
+
+$caching = $smarty->getCaching(); // get $smarty->caching
+$smarty->setCaching(true); // set $smarty->caching
+$smarty->setDeprecationNotices(false); // set $smarty->deprecation_notices
+$smarty->setCacheId($id); // set $smarty->cache_id
+$debugging = $smarty->getDebugging(); // get $smarty->debugging
+
+
+FILE STRUCTURE
+
+The Smarty 3 file structure is similar to Smarty 2:
+
+/libs/
+ Smarty.class.php
+/libs/sysplugins/
+ internal.*
+/libs/plugins/
+ function.mailto.php
+ modifier.escape.php
+ ...
+
+A lot of Smarty 3 core functionality lies in the sysplugins directory; you do
+not need to change any files here. The /libs/plugins/ folder is where Smarty
+plugins are located. You can add your own here, or create a separate plugin
+directory, just the same as Smarty 2. You will still need to create your own
+/cache/, /templates/, /templates_c/, /configs/ folders. Be sure /cache/ and
+/templates_c/ are writable.
+
+The typical way to use Smarty 3 should also look familiar:
+
+require('Smarty.class.php');
+$smarty = new Smarty;
+$smarty->assign('foo','bar');
+$smarty->display('index.tpl');
+
+
+However, Smarty 3 works completely different on the inside. Smarty 3 is mostly
+backward compatible with Smarty 2, except for the following items:
+
+*) Smarty 3 is PHP 5 only. It will not work with PHP 4.
+*) The {php} tag is disabled by default. Enable with $smarty->allow_php_tag=true.
+*) Delimiters surrounded by whitespace are no longer treated as Smarty tags.
+ Therefore, { foo } will not compile as a tag, you must use {foo}. This change
+ Makes Javascript/CSS easier to work with, eliminating the need for {literal}.
+ This can be disabled by setting $smarty->auto_literal = false;
+*) The Smarty 3 API is a bit different. Many Smarty 2 API calls are deprecated
+ but still work. You will want to update your calls to Smarty 3 for maximum
+ efficiency.
+
+
+There are many things that are new to Smarty 3. Here are the notable items:
+
+LEXER/PARSER
+============
+
+Smarty 3 now uses a lexing tokenizer for its parser/compiler. Basically, this
+means Smarty has some syntax additions that make life easier such as in-template
+math, shorter/intuitive function parameter options, infinite function recursion,
+more accurate error handling, etc.
+
+
+WHAT IS NEW IN SMARTY TEMPLATE SYNTAX
+=====================================
+
+Smarty 3 allows expressions almost anywhere. Expressions can include PHP
+functions as long as they are not disabled by the security policy, object
+methods and properties, etc. The {math} plugin is no longer necessary but
+is still supported for BC.
+
+Examples:
+{$x+$y} will output the sum of x and y.
+{$foo = strlen($bar)} function in assignment
+{assign var=foo value= $x+$y} in attributes
+{$foo = myfunct( ($x+$y)*3 )} as function parameter
+{$foo[$x+3]} as array index
+
+Smarty tags can be used as values within other tags.
+Example: {$foo={counter}+3}
+
+Smarty tags can also be used inside double quoted strings.
+Example: {$foo="this is message {counter}"}
+
+You can define arrays within templates.
+Examples:
+{assign var=foo value=[1,2,3]}
+{assign var=foo value=['y'=>'yellow','b'=>'blue']}
+Arrays can be nested.
+{assign var=foo value=[1,[9,8],3]}
+
+There is a new short syntax supported for assigning variables.
+Example: {$foo=$bar+2}
+
+You can assign a value to a specific array element. If the variable exists but
+is not an array, it is converted to an array before the new values are assigned.
+Examples:
+{$foo['bar']=1}
+{$foo['bar']['blar']=1}
+
+You can append values to an array. If the variable exists but is not an array,
+it is converted to an array before the new values are assigned.
+Example: {$foo[]=1}
+
+You can use a PHP-like syntax for accessing array elements, as well as the
+original "dot" notation.
+Examples:
+{$foo[1]} normal access
+{$foo['bar']}
+{$foo['bar'][1]}
+{$foo[$x+$x]} index may contain any expression
+{$foo[$bar[1]]} nested index
+{$foo[section_name]} smarty section access, not array access!
+
+The original "dot" notation stays, and with improvements.
+Examples:
+{$foo.a.b.c} => $foo['a']['b']['c']
+{$foo.a.$b.c} => $foo['a'][$b]['c'] with variable index
+{$foo.a.{$b+4}.c} => $foo['a'][$b+4]['c'] with expression as index
+{$foo.a.{$b.c}} => $foo['a'][$b['c']] with nested index
+
+note that { and } are used to address ambiguties when nesting the dot syntax.
+
+Variable names themselves can be variable and contain expressions.
+Examples:
+$foo normal variable
+$foo_{$bar} variable name containing other variable
+$foo_{$x+$y} variable name containing expressions
+$foo_{$bar}_buh_{$blar} variable name with multiple segments
+{$foo_{$x}} will output the variable $foo_1 if $x has a value of 1.
+
+Object method chaining is implemented.
+Example: {$object->method1($x)->method2($y)}
+
+{for} tag added for looping (replacement for {section} tag):
+{for $x=0, $y=count($foo); $x<$y; $x++} .... {/for}
+Any number of statements can be used separated by comma as the first
+inital expression at {for}.
+
+{for $x = $start to $end step $step} ... {/for}is in the SVN now .
+You can use also
+{for $x = $start to $end} ... {/for}
+In this case the step value will be automaticall 1 or -1 depending on the start and end values.
+Instead of $start and $end you can use any valid expression.
+Inside the loop the following special vars can be accessed:
+$x@iteration = number of iteration
+$x@total = total number of iterations
+$x@first = true on first iteration
+$x@last = true on last iteration
+
+
+The Smarty 2 {section} syntax is still supported.
+
+New shorter {foreach} syntax to loop over an array.
+Example: {foreach $myarray as $var}...{/foreach}
+
+Within the foreach loop, properties are access via:
+
+$var@key foreach $var array key
+$var@iteration foreach current iteration count (1,2,3...)
+$var@index foreach current index count (0,1,2...)
+$var@total foreach $var array total
+$var@first true on first iteration
+$var@last true on last iteration
+
+The Smarty 2 {foreach} tag syntax is still supported.
+
+NOTE: {$bar[foo]} still indicates a variable inside of a {section} named foo.
+If you want to access an array element with index foo, you must use quotes
+such as {$bar['foo']}, or use the dot syntax {$bar.foo}.
+
+while block tag is now implemented:
+{while $foo}...{/while}
+{while $x lt 10}...{/while}
+
+Direct access to PHP functions:
+Just as you can use PHP functions as modifiers directly, you can now access
+PHP functions directly, provided they are permitted by security settings:
+{time()}
+
+There is a new {function}...{/function} block tag to implement a template function.
+This enables reuse of code sequences like a plugin function. It can call itself recursively.
+Template function must be called with the new {call name=foo...} tag.
+
+Example:
+
+Template file:
+{function name=menu level=0}
+
+ {foreach $data as $entry}
+ {if is_array($entry)}
+
+{/function}
+
+{$menu = ['item1','item2','item3' => ['item3-1','item3-2','item3-3' =>
+ ['item3-3-1','item3-3-2']],'item4']}
+
+{call name=menu data=$menu}
+
+
+Generated output:
+ * item1
+ * item2
+ * item3
+ o item3-1
+ o item3-2
+ o item3-3
+ + item3-3-1
+ + item3-3-2
+ * item4
+
+The function tag itself must have the "name" attribute. This name is the tag
+name when calling the function. The function tag may have any number of
+additional attributes. These will be default settings for local variables.
+
+New {nocache} block function:
+{nocache}...{/nocache} will declare a section of the template to be non-cached
+when template caching is enabled.
+
+New nocache attribute:
+You can declare variable/function output as non-cached with the nocache attribute.
+Examples:
+
+{$foo nocache=true}
+{$foo nocache} /* same */
+
+{foo bar="baz" nocache=true}
+{foo bar="baz" nocache} /* same */
+
+{time() nocache=true}
+{time() nocache} /* same */
+
+Or you can also assign the variable in your script as nocache:
+$smarty->assign('foo',$something,true); // third param is nocache setting
+{$foo} /* non-cached */
+
+$smarty.current_dir returns the directory name of the current template.
+
+You can use strings directly as templates with the "string" resource type.
+Examples:
+$smarty->display('string:This is my template, {$foo}!'); // php
+{include file="string:This is my template, {$foo}!"} // template
+
+
+
+VARIABLE SCOPE / VARIABLE STORAGE
+=================================
+
+In Smarty 2, all assigned variables were stored within the Smarty object.
+Therefore, all variables assigned in PHP were accessible by all subsequent
+fetch and display template calls.
+
+In Smarty 3, we have the choice to assign variables to the main Smarty object,
+to user-created data objects, and to user-created template objects.
+These objects can be chained. The object at the end of a chain can access all
+variables belonging to that template and all variables within the parent objects.
+The Smarty object can only be the root of a chain, but a chain can be isolated
+from the Smarty object.
+
+All known Smarty assignment interfaces will work on the data and template objects.
+
+Besides the above mentioned objects, there is also a special storage area for
+global variables.
+
+A Smarty data object can be created as follows:
+$data = $smarty->createData(); // create root data object
+$data->assign('foo','bar'); // assign variables as usual
+$data->config_load('my.conf'); // load config file
+
+$data= $smarty->createData($smarty); // create data object having a parent link to
+the Smarty object
+
+$data2= $smarty->createData($data); // create data object having a parent link to
+the $data data object
+
+A template object can be created by using the createTemplate method. It has the
+same parameter assignments as the fetch() or display() method.
+Function definition:
+function createTemplate($template, $cache_id = null, $compile_id = null, $parent = null)
+
+The first parameter can be a template name, a smarty object or a data object.
+
+Examples:
+$tpl = $smarty->createTemplate('mytpl.tpl'); // create template object not linked to any parent
+$tpl->assign('foo','bar'); // directly assign variables
+$tpl->config_load('my.conf'); // load config file
+
+$tpl = $smarty->createTemplate('mytpl.tpl',$smarty); // create template having a parent link to the Smarty object
+$tpl = $smarty->createTemplate('mytpl.tpl',$data); // create template having a parent link to the $data object
+
+The standard fetch() and display() methods will implicitly create a template object.
+If the $parent parameter is not specified in these method calls, the template object
+is will link back to the Smarty object as it's parent.
+
+If a template is called by an {include...} tag from another template, the
+subtemplate links back to the calling template as it's parent.
+
+All variables assigned locally or from a parent template are accessible. If the
+template creates or modifies a variable by using the {assign var=foo...} or
+{$foo=...} tags, these new values are only known locally (local scope). When the
+template exits, none of the new variables or modifications can be seen in the
+parent template(s). This is same behavior as in Smarty 2.
+
+With Smarty 3, we can assign variables with a scope attribute which allows the
+availablility of these new variables or modifications globally (ie in the parent
+templates.)
+
+Possible scopes are local, parent, root and global.
+Examples:
+{assign var=foo value='bar'} // no scope is specified, the default 'local'
+{$foo='bar'} // same, local scope
+{assign var=foo value='bar' scope='local'} // same, local scope
+
+{assign var=foo value='bar' scope='parent'} // Values will be available to the parent object
+{$foo='bar' scope='parent'} // (normally the calling template)
+
+{assign var=foo value='bar' scope='root'} // Values will be exported up to the root object, so they can
+{$foo='bar' scope='root'} // be seen from all templates using the same root.
+
+{assign var=foo value='bar' scope='global'} // Values will be exported to global variable storage,
+{$foo='bar' scope='global'} // they are available to any and all templates.
+
+
+The scope attribute can also be attached to the {include...} tag. In this case,
+the specified scope will be the default scope for all assignments within the
+included template.
+
+
+PLUGINS
+=======
+
+Smarty3 are following the same coding rules as in Smarty2.
+The only difference is that the template object is passed as additional third parameter.
+
+smarty_plugintype_name (array $params, object $smarty, object $template)
+
+The Smarty 2 plugins are still compatible as long as they do not make use of specific Smarty2 internals.
+
+
+TEMPLATE INHERITANCE:
+=====================
+
+With template inheritance you can define blocks, which are areas that can be
+overriden by child templates, so your templates could look like this:
+
+parent.tpl:
+
+
+ {block name='title'}My site name{/block}
+
+
+
+
+
+
+child.tpl:
+{extends file='parent.tpl'}
+{block name='title'}
+Child title
+{/block}
+
+grandchild.tpl:
+{extends file='child.tpl'}
+{block name='title'}Home - {$smarty.block.parent}{/block}
+{block name='page-title'}My home{/block}
+{block name='content'}
+ {foreach $images as $img}
+
+ {/foreach}
+{/block}
+
+We redefined all the blocks here, however in the title block we used {$smarty.block.parent},
+which tells Smarty to insert the default content from the parent template in its place.
+The content block was overriden to display the image files, and page-title has also be
+overriden to display a completely different title.
+
+If we render grandchild.tpl we will get this:
+
+
+ Home - Child title
+
+
+
My home
+
+
+
+
+
+
+
+
+NOTE: In the child templates everything outside the {extends} or {block} tag sections
+is ignored.
+
+The inheritance tree can be as big as you want (meaning you can extend a file that
+extends another one that extends another one and so on..), but be aware that all files
+have to be checked for modifications at runtime so the more inheritance the more overhead you add.
+
+Instead of defining the parent/child relationships with the {extends} tag in the child template you
+can use the resource as follow:
+
+$smarty->display('extends:parent.tpl|child.tpl|grandchild.tpl');
+
+Child {block} tags may optionally have a append or prepend attribute. In this case the parent block content
+is appended or prepended to the child block content.
+
+{block name='title' append} My title {/block}
+
+
+PHP STREAMS:
+============
+
+(see online documentation)
+
+VARIBLE FILTERS:
+================
+
+(see online documentation)
+
+
+STATIC CLASS ACCESS AND NAMESPACE SUPPORT
+=========================================
+
+You can register a class with optional namespace for the use in the template like:
+
+$smarty->register->templateClass('foo','name\name2\myclass');
+
+In the template you can use it like this:
+{foo::method()} etc.
+
+
+=======================
+
+Please look through it and send any questions/suggestions/etc to the forums.
+
+http://www.phpinsider.com/smarty-forum/viewtopic.php?t=14168
+
+Monte and Uwe
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/SMARTY_2_BC_NOTES.txt b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/SMARTY_2_BC_NOTES.txt
new file mode 100644
index 000000000..79a2cb1b6
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/SMARTY_2_BC_NOTES.txt
@@ -0,0 +1,109 @@
+= Known incompatibilities with Smarty 2 =
+
+== Syntax ==
+
+Smarty 3 API has a new syntax. Much of the Smarty 2 syntax is supported
+by a wrapper but deprecated. See the README that comes with Smarty 3 for more
+information.
+
+The {$array|@mod} syntax has always been a bit confusing, where an "@" is required
+to apply a modifier to an array instead of the individual elements. Normally you
+always want the modifier to apply to the variable regardless of its type. In Smarty 3,
+{$array|mod} and {$array|@mod} behave identical. It is safe to drop the "@" and the
+modifier will still apply to the array. If you really want the modifier to apply to
+each array element, you must loop the array in-template, or use a custom modifier that
+supports array iteration. Most smarty functions already escape values where necessary
+such as {html_options}
+
+== PHP Version ==
+Smarty 3 is PHP 5 only. It will not work with PHP 4.
+
+== {php} Tag ==
+The {php} tag is disabled by default. The use of {php} tags is
+deprecated. It can be enabled with $smarty->allow_php_tag=true.
+
+But if you scatter PHP code which belongs together into several
+{php} tags it may not work any longer.
+
+== Delimiters and whitespace ==
+Delimiters surrounded by whitespace are no longer treated as Smarty tags.
+Therefore, { foo } will not compile as a tag, you must use {foo}. This change
+Makes Javascript/CSS easier to work with, eliminating the need for {literal}.
+This can be disabled by setting $smarty->auto_literal = false;
+
+== Unquoted Strings ==
+Smarty 2 was a bit more forgiving (and ambiguous) when it comes to unquoted strings
+in parameters. Smarty3 is more restrictive. You can still pass strings without quotes
+so long as they contain no special characters. (anything outside of A-Za-z0-9_)
+
+For example filename strings must be quoted
+
+{include file='path/foo.tpl'}
+
+
+== Extending the Smarty class ==
+Smarty 3 makes use of the __construct method for initialization. If you are extending
+the Smarty class, its constructor is not called implicitly if the your child class defines
+its own constructor. In order to run Smarty's constructor, a call to parent::__construct()
+within your child constructor is required.
+
+
+class MySmarty extends Smarty {
+ function __construct() {
+ parent::__construct();
+
+ // your initialization code goes here
+
+ }
+}
+
+
+== Autoloader ==
+Smarty 3 does register its own autoloader with spl_autoload_register. If your code has
+an existing __autoload function then this function must be explicitly registered on
+the __autoload stack. See http://us3.php.net/manual/en/function.spl-autoload-register.php
+for further details.
+
+== Plugin Filenames ==
+Smarty 3 optionally supports the PHP spl_autoloader. The autoloader requires filenames
+to be lower case. Because of this, Smarty plugin file names must also be lowercase.
+In Smarty 2, mixed case file names did work.
+
+== Scope of Special Smarty Variables ==
+In Smarty 2 the special Smarty variables $smarty.section... and $smarty.foreach...
+had global scope. If you had loops with the same name in subtemplates you could accidentally
+overwrite values of parent template.
+
+In Smarty 3 these special Smarty variable have only local scope in the template which
+is defining the loop. If you need their value in a subtemplate you have to pass them
+as parameter.
+
+{include file='path/foo.tpl' index=$smarty.section.foo.index}
+
+
+== SMARTY_RESOURCE_CHAR_SET ==
+Smarty 3 sets the constant SMARTY_RESOURCE_CHAR_SET to utf-8 as default template charset.
+This is now used also on modifiers like escape as default charset. If your templates use
+other charsets make sure that you define the constant accordingly. Otherwise you may not
+get any output.
+
+== newline at {if} tags ==
+A \n was added to the compiled code of the {if},{else},{elseif},{/if} tags to get output of newlines as expected by the template source.
+If one of the {if} tags is at the line end you will now get a newline in the HTML output.
+
+== trigger_error() ==
+The API function trigger_error() has been removed because it did just map to PHP trigger_error.
+However it's still included in the Smarty2 API wrapper.
+
+== Smarty constants ==
+The constants
+SMARTY_PHP_PASSTHRU
+SMARTY_PHP_QUOTE
+SMARTY_PHP_REMOVE
+SMARTY_PHP_ALLOW
+have been replaced with class constants
+Smarty::PHP_PASSTHRU
+Smarty::PHP_QUOTE
+Smarty::PHP_REMOVE
+Smarty::PHP_ALLOW
+
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/SMARTY_3.0_BC_NOTES.txt b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/SMARTY_3.0_BC_NOTES.txt
new file mode 100644
index 000000000..fd8b540c2
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/SMARTY_3.0_BC_NOTES.txt
@@ -0,0 +1,24 @@
+== Smarty2 backward compatibility ==
+All Smarty2 specific API functions and deprecated functionallity has been moved
+to the SmartyBC class.
+
+== {php} Tag ==
+The {php} tag is no longer available in the standard Smarty calls.
+The use of {php} tags is deprecated and only available in the SmartyBC class.
+
+== {include_php} Tag ==
+The {include_php} tag is no longer available in the standard Smarty calls.
+The use of {include_php} tags is deprecated and only available in the SmartyBC class.
+
+== php template resource ==
+The support of the php template resource is removed.
+
+== $cache_dir, $compile_dir, $config_dir, $template_dir access ==
+The mentioned properties can't be accessed directly any longer. You must use
+corresponding getter/setters like addConfigDir(), setConfigDir(), getConfigDir()
+
+== obsolete Smarty class properties ==
+The following no longer used properties are removed:
+$allow_php_tag
+$allow_php_template
+$deprecation_notices
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/SMARTY_3.1_NOTES.txt b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/SMARTY_3.1_NOTES.txt
new file mode 100644
index 000000000..e56e56f67
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/SMARTY_3.1_NOTES.txt
@@ -0,0 +1,306 @@
+Smarty 3.1 Notes
+================
+
+Smarty 3.1 is a departure from 2.0 compatibility. Most notably, all
+backward compatibility has been moved to a separate class file named
+SmartyBC.class.php. If you require compatibility with 2.0, you will
+need to use this class.
+
+Some differences from 3.0 are also present. 3.1 begins the journey of
+requiring setters/getters for property access. So far this is only
+implemented on the five directory properties: template_dir,
+plugins_dir, configs_dir, compile_dir and cache_dir. These properties
+are now protected, it is required to use the setters/getters instead.
+That said, direct property access will still work, however slightly
+slower since they will now fall through __set() and __get() and in
+turn passed through the setter/getter methods. 3.2 will exhibit a full
+list of setter/getter methods for all (currently) public properties,
+so code-completion in your IDE will work as expected.
+
+There is absolutely no PHP allowed in templates any more. All
+deprecated features of Smarty 2.0 are gone. Again, use the SmartyBC
+class if you need any backward compatibility.
+
+Internal Changes
+
+ Full UTF-8 Compatibility
+
+The plugins shipped with Smarty 3.1 have been rewritten to fully
+support UTF-8 strings if Multibyte String is available. Without
+MBString UTF-8 cannot be handled properly. For those rare cases where
+templates themselves have to juggle encodings, the new modifiers
+to_charset and from_charset may come in handy.
+
+ Plugin API and Performance
+
+All Plugins (modifiers, functions, blocks, resources,
+default_template_handlers, etc) are now receiving the
+Smarty_Internal_Template instance, where they were supplied with the
+Smarty instance in Smarty 3.0. *. As The Smarty_Internal_Template
+mimics the behavior of Smarty, this API simplification should not
+require any changes to custom plugins.
+
+The plugins shipped with Smarty 3.1 have been rewritten for better
+performance. Most notably {html_select_date} and {html_select_time}
+have been improved vastly. Performance aside, plugins have also been
+reviewed and generalized in their API. {html_select_date} and
+{html_select_time} now share almost all available options.
+
+The escape modifier now knows the $double_encode option, which will
+prevent entities from being encoded again.
+
+The capitalize modifier now know the $lc_rest option, which makes sure
+all letters following a captial letter are lower-cased.
+
+The count_sentences modifier now accepts (.?!) as
+legitimate endings of a sentence - previously only (.) was
+accepted
+
+The new unescape modifier is there to reverse the effects of the
+escape modifier. This applies to the escape formats html, htmlall and
+entity.
+
+ default_template_handler_func
+
+The invocation of $smarty->$default_template_handler_func had to be
+altered. Instead of a Smarty_Internal_Template, the fifth argument is
+now provided with the Smarty instance. New footprint:
+
+
+/**
+ * Default Template Handler
+ *
+ * called when Smarty's file: resource is unable to load a requested file
+ *
+ * @param string $type resource type (e.g. "file", "string", "eval", "resource")
+ * @param string $name resource name (e.g. "foo/bar.tpl")
+ * @param string &$content template's content
+ * @param integer &$modified template's modification time
+ * @param Smarty $smarty Smarty instance
+ * @return string|boolean path to file or boolean true if $content and $modified
+ * have been filled, boolean false if no default template
+ * could be loaded
+ */
+function default_template_handler_func($type, $name, &$content, &$modified, Smarty $smarty) {
+ if (false) {
+ // return corrected filepath
+ return "/tmp/some/foobar.tpl";
+ } elseif (false) {
+ // return a template directly
+ $content = "the template source";
+ $modified = time();
+ return true;
+ } else {
+ // tell smarty that we failed
+ return false;
+ }
+}
+
+ Stuff done to the compiler
+
+Many performance improvements have happened internally. One notable
+improvement is that all compiled templates are now handled as PHP
+functions. This speeds up repeated templates tremendously, as each one
+calls an (in-memory) PHP function instead of performing another file
+include/scan.
+
+New Features
+
+ Template syntax
+
+ {block}..{/block}
+
+The {block} tag has a new hide option flag. It does suppress the block
+content if no corresponding child block exists.
+EXAMPLE:
+parent.tpl
+{block name=body hide} child content "{$smarty.block.child}" was
+inserted {block}
+In the above example the whole block will be suppressed if no child
+block "body" is existing.
+
+ {setfilter}..{/setfilter}
+
+The new {setfilter} block tag allows the definition of filters which
+run on variable output.
+SYNTAX:
+{setfilter filter1|filter2|filter3....}
+Smarty3 will lookup up matching filters in the following search order:
+1. varibale filter plugin in plugins_dir.
+2. a valid modifier. A modifier specification will also accept
+additional parameter like filter2:'foo'
+3. a PHP function
+{/setfilter} will turn previous filter setting off again.
+{setfilter} tags can be nested.
+EXAMPLE:
+{setfilter filter1}
+ {$foo}
+ {setfilter filter2}
+ {$bar}
+ {/setfilter}
+ {$buh}
+{/setfilter}
+{$blar}
+In the above example filter1 will run on the output of $foo, filter2
+on $bar, filter1 again on $buh and no filter on $blar.
+NOTES:
+- {$foo nofilter} will suppress the filters
+- These filters will run in addition to filters defined by
+registerFilter('variable',...), autoLoadFilter('variable',...) and
+defined default modifier.
+- {setfilter} will effect only the current template, not included
+subtemplates.
+
+ Resource API
+
+Smarty 3.1 features a new approach to resource management. The
+Smarty_Resource API allows simple, yet powerful integration of custom
+resources for templates and configuration files. It offers simple
+functions for loading data from a custom resource (e.g. database) as
+well as define new template types adhering to the special
+non-compiling (e,g, plain php) and non-compile-caching (e.g. eval:
+resource type) resources.
+
+See demo/plugins/resource.mysql.php for an example custom database
+resource.
+
+Note that old-fashioned registration of callbacks for resource
+management has been deprecated but is still possible with SmartyBC.
+
+ CacheResource API
+
+In line with the Resource API, the CacheResource API offers a more
+comfortable handling of output-cache data. With the
+Smarty_CacheResource_Custom accessing databases is made simple. With
+the introduction of Smarty_CacheResource_KeyValueStore the
+implementation of resources like memcache or APC became a no-brainer;
+simple hash-based storage systems are now supporting hierarchical
+output-caches.
+
+See demo/plugins/cacheresource.mysql.php for an example custom
+database CacheResource.
+See demo/plugins/cacheresource.memcache.php for an example custom
+memcache CacheResource using the KeyValueStore helper.
+
+Note that old-fashioned registration of $cache_handler is not possible
+anymore. As the functionality had not been ported to Smarty 3.0.x
+properly, it has been dropped from 3.1 completely.
+
+Locking facilities have been implemented to avoid concurrent cache
+generation. Enable cache locking by setting
+$smarty->cache_locking = true;
+
+ Relative Paths in Templates (File-Resource)
+
+As of Smarty 3.1 {include file="../foo.tpl"} and {include
+file="./foo.tpl"} will resolve relative to the template they're in.
+Relative paths are available with {include file="..."} and
+{extends file="..."}. As $smarty->fetch('../foo.tpl') and
+$smarty->fetch('./foo.tpl') cannot be relative to a template, an
+exception is thrown.
+
+ Adressing a specific $template_dir
+
+Smarty 3.1 introduces the $template_dir index notation.
+$smarty->fetch('[foo]bar.tpl') and {include file="[foo]bar.tpl"}
+require the template bar.tpl to be loaded from $template_dir['foo'];
+Smarty::setTemplateDir() and Smarty::addTemplateDir() offer ways to
+define indexes along with the actual directories.
+
+ Mixing Resources in extends-Resource
+
+Taking the php extends: template resource one step further, it is now
+possible to mix resources within an extends: call like
+$smarty->fetch("extends:file:foo.tpl|db:bar.tpl");
+
+To make eval: and string: resources available to the inheritance
+chain, eval:base64:TPL_STRING and eval:urlencode:TPL_STRING have been
+introduced. Supplying the base64 or urlencode flags will trigger
+decoding the TPL_STRING in with either base64_decode() or urldecode().
+
+ extends-Resource in template inheritance
+
+Template based inheritance may now inherit from php's extends:
+resource like {extends file="extends:foo.tpl|db:bar.tpl"}.
+
+ New Smarty property escape_html
+
+$smarty->escape_html = true will autoescape all template variable
+output by calling htmlspecialchars({$output}, ENT_QUOTES,
+SMARTY_RESOURCE_CHAR_SET).
+NOTE:
+This is a compile time option. If you change the setting you must make
+sure that the templates get recompiled.
+
+ New option at Smarty property compile_check
+
+The automatic recompilation of modified templates can now be
+controlled by the following settings:
+$smarty->compile_check = COMPILECHECK_OFF (false) - template files
+will not be checked
+$smarty->compile_check = COMPILECHECK_ON (true) - template files will
+always be checked
+$smarty->compile_check = COMPILECHECK_CACHEMISS - template files will
+be checked if caching is enabled and there is no existing cache file
+or it has expired
+
+ Automatic recompilation on Smarty version change
+
+Templates will now be automatically recompiled on Smarty version
+changes to avoide incompatibillities in the compiled code. Compiled
+template checked against the current setting of the SMARTY_VERSION
+constant.
+
+ default_config_handler_func()
+
+Analogous to the default_template_handler_func()
+default_config_handler_func() has been introduced.
+
+ default_plugin_handler_func()
+
+An optional default_plugin_handler_func() can be defined which gets called
+by the compiler on tags which can't be resolved internally or by plugins.
+The default_plugin_handler() can map tags to plugins on the fly.
+
+New getters/setters
+
+The following setters/getters will be part of the official
+documentation, and will be strongly recommended. Direct property
+access will still work for the foreseeable future... it will be
+transparently routed through the setters/getters, and consequently a
+bit slower.
+
+array|string getTemplateDir( [string $index] )
+replaces $smarty->template_dir; and $smarty->template_dir[$index];
+Smarty setTemplateDir( array|string $path )
+replaces $smarty->template_dir = "foo"; and $smarty->template_dir =
+array("foo", "bar");
+Smarty addTemplateDir( array|string $path, [string $index])
+replaces $smarty->template_dir[] = "bar"; and
+$smarty->template_dir[$index] = "bar";
+
+array|string getConfigDir( [string $index] )
+replaces $smarty->config_dir; and $smarty->config_dir[$index];
+Smarty setConfigDir( array|string $path )
+replaces $smarty->config_dir = "foo"; and $smarty->config_dir =
+array("foo", "bar");
+Smarty addConfigDir( array|string $path, [string $index])
+replaces $smarty->config_dir[] = "bar"; and
+$smarty->config_dir[$index] = "bar";
+
+array getPluginsDir()
+replaces $smarty->plugins_dir;
+Smarty setPluginsDir( array|string $path )
+replaces $smarty->plugins_dir = "foo";
+Smarty addPluginsDir( array|string $path )
+replaces $smarty->plugins_dir[] = "bar";
+
+string getCompileDir()
+replaces $smarty->compile_dir;
+Smarty setCompileDir( string $path )
+replaces $smarty->compile_dir = "foo";
+
+string getCacheDir()
+replaces $smarty->cache_dir;
+Smarty setCacheDir( string $path )
+replaces $smarty->cache_dir;
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/change_log.txt b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/change_log.txt
new file mode 100644
index 000000000..69642e276
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/change_log.txt
@@ -0,0 +1,2153 @@
+===== Smarty-3.1.13 =====
+13.01.2013
+- enhancement allow to disable exception message escaping by SmartyException::$escape = false; (Issue #130)
+
+09.01.2013
+- bugfix compilation did fail when a prefilter did modify an {extends} tag (Forum Topic 23966)
+- bugfix template inheritance could fail if nested {block} tags in childs did contain {$smarty.block.child} (Issue #127)
+- bugfix template inheritance could fail if {block} tags in childs did have similar name as used plugins (Issue #128)
+- added abstract method declaration doCompile() in Smarty_Internal_TemplateCompilerBase (Forum Topic 23969)
+
+06.01.2013
+- Allow '://' URL syntax in template names of stream resources (Issue #129)
+
+27.11.2012
+- bugfix wrong variable usage in smarty_internal_utility.php (Issue #125)
+
+26.11.2012
+- bugfix global variable assigned within template function are not seen after template function exit (Forum Topic 23800)
+
+24.11.2012
+- made SmartyBC loadable via composer (Issue #124)
+
+20.11.2012
+- bugfix assignGlobal() called from plugins did not work (Forum Topic 23771)
+
+13.11.2012
+- adding attribute "strict" to html_options, html_checkboxes, html_radios to only print disabled/readonly attributes if their values are true or "disabled"/"readonly" (Issue #120)
+
+01.11.2012
+- bugfix muteExcpetedErrors() would screw up for non-readable paths (Issue #118)
+
+===== Smarty-3.1.12 =====
+14.09.2012
+- bugfix template inheritance failed to compile with delimiters {/ and /} (Forum Topic 23008)
+
+11.09.2012
+- bugfix escape Smarty exception messages to avoid possible script execution
+
+10.09.2012
+- bugfix tag option flags and shorttag attributes did not work when rdel started with '=' (Forum Topic 22979)
+
+31.08.2012
+- bugfix resolving relative paths broke in some circumstances (Issue #114)
+
+22.08.2012
+- bugfix test MBString availability through mb_split, as it could've been compiled without regex support (--enable-mbregex).
+ Either we get MBstring's full package, or we pretend it's not there at all.
+
+21.08.2012
+- bugfix $auto_literal = false did not work with { block} tags in child templates
+ (problem was reintroduced after fix in 3.1.7)(Forum Topic 20581)
+
+17.08.2012
+- bugfix compiled code of nocache sections could contain wrong escaping (Forum Topic 22810)
+
+15.08.2012
+- bugfix template inheritance did produce wrong code if subtemplates with {block} was
+ included several times (from smarty-developers forum)
+
+14.08.2012
+- bugfix PHP5.2 compatibility compromised by SplFileInfo::getBasename() (Issue 110)
+
+01.08.2012
+- bugfix avoid PHP error on $smarty->configLoad(...) with invalid section specification (Forum Topic 22608)
+
+30.07.2012
+-bugfix {assign} in a nocache section should not overwrite existing variable values
+ during compilation (issue 109)
+
+28.07.2012
+- bugfix array access of config variables did not work (Forum Topic 22527)
+
+19.07.2012
+- bugfix the default plugin handler did create wrong compiled code for static class methods
+ from external script files (issue 108)
+
+===== Smarty-3.1.11 =====
+30.06.2012
+- bugfix {block.. hide} did not work as nested child (Forum Topic 22216)
+
+25.06.2012
+- bugfix the default plugin handler did not allow static class methods for modifier (issue 85)
+
+24.06.2012
+- bugfix escape modifier support for PHP < 5.2.3 (Forum Topic 21176)
+
+11.06.2012
+- bugfix the patch for Topic 21856 did break tabs between tag attributes (Forum Topic 22124)
+
+===== Smarty-3.1.10 =====
+09.06.2012
+- bugfix the compiler did ignore registered compiler plugins for closing tags (Forum Topic 22094)
+- bugfix the patch for Topic 21856 did break multiline tags (Forum Topic 22124)
+
+===== Smarty-3.1.9 =====
+07.06.2012
+- bugfix fetch() and display() with relative paths (Issue 104)
+- bugfix treat "0000-00-00" as 0 in modifier.date_format (Issue 103)
+
+24.05.2012
+- bugfix Smarty_Internal_Write_File::writeFile() could cause race-conditions on linux systems (Issue 101)
+- bugfix attribute parameter names of plugins may now contain also "-" and ":" (Forum Topic 21856)
+- bugfix add compile_id to cache key of of source (Issue 97)
+
+22.05.2012
+- bugfix recursive {include} within {section} did fail (Smarty developer group)
+
+12.05.2012
+- bugfix {html_options} did not properly escape values (Issue 98)
+
+03.05.2012
+- bugfix make HTTP protocall version variable (issue 96)
+
+02.05.2012
+- bugfix {nocache}{block}{plugin}... did produce wrong compiled code when caching is disabled (Forum Topic 21572, issue 95)
+
+12.04.2012
+- bugfix Smarty did eat the linebreak after the closing tag (Issue 93)
+- bugfix concurrent cache updates could create a warning (Forum Topic 21403)
+
+08.04.2012
+- bugfix "\\" was not escaped correctly when generating nocache code (Forum Topic 21364)
+
+30.03.2012
+- bugfix template inheritance did not throw exception when a parent template was deleted (issue 90)
+
+27.03.2012
+- bugfix prefilter did run multiple times on inline subtemplates compiled into several main templates (Forum Topic 21325)
+- bugfix implement Smarty2's behaviour of variables assigned by reference in SmartyBC. {assign} will affect all references.
+ (issue 88)
+
+21.03.2012
+- bugfix compileAllTemplates() and compileAllConfig() did not return the number of compiled files (Forum Topic 21286)
+
+13.03.2012
+- correction of yesterdays bugfix (Forum Topic 21175 and 21182)
+
+12.03.2012
+- bugfix a double quoted string of "$foo" did not compile into PHP "$foo" (Forum Topic 21175)
+- bugfix template inheritance did set $merge_compiled_includes globally true
+
+03.03.2012
+- optimization of compiling speed when same modifier was used several times
+
+02.03.2012
+- enhancement the default plugin handler can now also resolve undefined modifier (Smarty::PLUGIN_MODIFIER)
+ (Issue 85)
+
+===== Smarty-3.1.8 =====
+19.02.2012
+- bugfix {include} could result in a fatal error if used in appended or prepended nested {block} tags
+ (reported by mh and Issue 83)
+- enhancement added Smarty special variable $smarty.template_object to return the current template object (Forum Topic 20289)
+
+
+07.02.2012
+- bugfix increase entropy of internal function names in compiled and cached template files (Forum Topic 20996)
+- enhancement cacheable parameter added to default plugin handler, same functionality as in registerPlugin (request by calguy1000)
+
+06.02.2012
+- improvement stream_resolve_include_path() added to Smarty_Internal_Get_Include_Path (Forum Topic 20980)
+- bugfix fetch('extends:foo.tpl') always yielded $source->exists == true (Forum Topic 20980)
+- added modifier unescape:"url", fix (Forum Topic 20980)
+- improvement replaced some calls of preg_replace with str_replace (Issue 73)
+
+30.01.2012
+- bugfix Smarty_Security internal $_resource_dir cache wasn't properly propagated
+
+27.01.2012
+- bugfix Smarty did not a template name of "0" (Forum Topic 20895)
+
+20.01.2012
+- bugfix typo in Smarty_Internal_Get_IncludePath did cause runtime overhead (Issue 74)
+- improvment remove unneeded assigments (Issue 75 and 76)
+- fixed typo in template parser
+- bugfix output filter must not run before writing cache when template does contain nocache code (Issue 71)
+
+02.01.2012
+- bugfix {block foo nocache} did not load plugins within child {block} in nocache mode (Forum Topic 20753)
+
+29.12.2011
+- bugfix enable more entropy in Smarty_Internal_Write_File for "more uniqueness" and Cygwin compatibility (Forum Topic 20724)
+- bugfix embedded quotes in single quoted strings did not compile correctly in {nocache} sections (Forum Topic 20730)
+
+28.12.2011
+- bugfix Smarty's internal header code must be excluded from postfilters (issue 71)
+
+22.12.2011
+- bugfix the new lexer of 17.12.2011 did fail if mbstring.func_overload != 0 (issue 70) (Forum Topic 20680)
+- bugfix template inheritace did fail if mbstring.func_overload != 0 (issue 70) (Forum Topic 20680)
+
+20.12.2011
+- bugfix template inheritance: {$smarty.block.child} in nested child {block} tags did not return
+ content after {$smarty.block.child} (Forum Topic 20564)
+
+===== Smarty-3.1.7 =====
+18.12.2011
+- bugfix strings ending with " in multiline strings of config files failed to compile (issue #67)
+- added chaining to Smarty_Internal_Templatebase
+- changed unloadFilter() to not return a boolean in favor of chaining and API conformity
+- bugfix unregisterObject() raised notice when object to unregister did not exist
+- changed internals to use Smarty::$_MBSTRING ($_CHARSET, $_DATE_FORMAT) for better unit testing
+- added Smarty::$_UTF8_MODIFIER for proper PCRE charset handling (Forum Topic 20452)
+- added Smarty_Security::isTrustedUri() and Smarty_Security::$trusted_uri to validate
+ remote resource calls through {fetch} and {html_image} (Forum Topic 20627)
+
+17.12.2011
+- improvement of compiling speed by new handling of plain text blocks in the lexer/parser (issue #68)
+
+16.12.2011
+- bugfix the source exits flag and timestamp was not setup when template was in php include path (issue #69)
+
+9.12.2011
+- bugfix {capture} tags around recursive {include} calls did throw exception (Forum Topic 20549)
+- bugfix $auto_literal = false did not work with { block} tags in child templates (Forum Topic 20581)
+- bugfix template inheritance: do not include code of {include} in overloaded {block} into compiled
+ parent template (Issue #66}
+- bugfix template inheritance: {$smarty.block.child} in nested child {block} tags did not return expected
+ result (Forum Topic 20564)
+
+===== Smarty-3.1.6 =====
+30.11.2011
+- bugfix is_cache() for individual cached subtemplates with $smarty->caching = CACHING_OFF did produce
+ an exception (Forum Topic 20531)
+
+29.11.2011
+- bugfix added exception if the default plugin handler did return a not static callback (Forum Topic 20512)
+
+25.11.2011
+- bugfix {html_select_date} and {html_slecet_time} did not default to current time if "time" was not specified
+ since r4432 (issue 60)
+
+24.11.2011
+- bugfix a subtemplate later used as main template did use old variable values
+
+21.11.2011
+- bugfix cache file could include unneeded modifier plugins under certain condition
+
+18.11.2011
+- bugfix declare all directory properties private to map direct access to getter/setter also on extended Smarty class
+
+16.11.2011
+- bugfix Smarty_Resource::load() did not always return a proper resource handler (Forum Topic 20414)
+- added escape argument to html_checkboxes and html_radios (Forum Topic 20425)
+
+===== Smarty-3.1.5 =====
+14.11.2011
+- bugfix allow space between function name and open bracket (forum topic 20375)
+
+09.11.2011
+- bugfix different behaviour of uniqid() on cygwin. See https://bugs.php.net/bug.php?id=34908
+ (forum topic 20343)
+
+01.11.2011
+- bugfix {if} and {while} tags without condition did not throw a SmartyCompilerException (Issue #57)
+- bugfix multiline strings in config files could fail on longer strings (reopened Issue #55)
+
+22.10.2011
+- bugfix smarty_mb_from_unicode() would not decode unicode-points properly
+- bugfix use catch Exception instead UnexpectedValueException in
+ clearCompiledTemplate to be PHP 5.2 compatible
+
+21.10.2011
+- bugfix apostrophe in plugins_dir path name failed (forum topic 20199)
+- improvement sha1() for array keys longer than 150 characters
+- add Smarty::$allow_ambiguous_resources to activate unique resource handling (Forum Topic 20128)
+
+20.10.2011
+- @silenced unlink() in Smarty_Internal_Write_File since debuggers go haywire without it.
+- bugfix Smarty::clearCompiledTemplate() threw an Exception if $cache_id was not present in $compile_dir when $use_sub_dirs = true.
+- bugfix {html_select_date} and {html_select_time} did not properly handle empty time arguments (Forum Topic 20190)
+- improvement removed unnecessary sha1()
+
+19.10.2011
+- revert PHP4 constructor message
+- fixed PHP4 constructor message
+
+===== Smarty-3.1.4 =====
+19.10.2011
+- added exception when using PHP4 style constructor
+
+16.10.2011
+- bugfix testInstall() did not propery check cache_dir and compile_dir
+
+15.10.2011
+- bugfix Smarty_Resource and Smarty_CacheResource runtime caching (Forum Post 75264)
+
+14.10.2011
+- bugfix unique_resource did not properly apply to compiled resources (Forum Topic 20128)
+- add locking to custom resources (Forum Post 75252)
+- add Smarty_Internal_Template::clearCache() to accompany isCached() fetch() etc.
+
+13.10.2011
+- add caching for config files in Smarty_Resource
+- bugfix disable of caching after isCached() call did not work (Forum Topic 20131)
+- add concept unique_resource to combat potentially ambiguous template_resource values when custom resource handlers are used (Forum Topic 20128)
+- bugfix multiline strings in config files could fail on longer strings (Issue #55)
+
+11.10.2011
+- add runtime checks for not matching {capture}/{/capture} calls (Forum Topic 20120)
+
+10.10.2011
+- bugfix variable name typo in {html_options} and {html_checkboxes} (Issue #54)
+- bugfix tag did create wrong output when caching enabled and the tag was in included subtemplate
+- bugfix Smarty_CacheResource_mysql example was missing strtotime() calls
+
+===== Smarty-3.1.3 =====
+07.10.2011
+- improvement removed html comments from {mailto} (Forum Topic 20092)
+- bugfix testInstall() would not show path to internal plugins_dir (Forum Post 74627)
+- improvement testInstall() now showing resolved paths and checking the include_path if necessary
+- bugfix html_options plugin did not handle object values properly (Issue #49, Forum Topic 20049)
+- improvement html_checkboxes and html_radios to accept null- and object values, and label_ids attribute
+- improvement removed some unnecessary count()s
+- bugfix parent pointer was not set when fetch() for other template was called on template object
+
+06.10.2011
+- bugfix switch lexer internals depending on mbstring.func_overload
+- bugfix start_year and end_year of {html_select_date} did not use current year as offset base (Issue #53)
+
+05.10.2011
+- bugfix of problem introduced with r4342 by replacing strlen() with isset()
+- add environment configuration issue with mbstring.func_overload Smarty cannot compensate for (Issue #45)
+- bugfix nofilter tag option did not disable default modifier
+- bugfix html_options plugin did not handle null- and object values properly (Issue #49, Forum Topic 20049)
+
+04.10.2011
+- bugfix assign() in plugins called in subtemplates did change value also in parent template
+- bugfix of problem introduced with r4342 on math plugin
+- bugfix output filter should not run on individually cached subtemplates
+- add unloadFilter() method
+- bugfix has_nocache_code flag was not reset before compilation
+
+===== Smarty-3.1.2 =====
+03.10.2011
+- improvement add internal $joined_template_dir property instead computing it on the fly several times
+
+01.10.2011
+- improvement replaced most in_array() calls by more efficient isset() on array_flip()ed haystacks
+- improvement replaced some strlen($foo) > 3 calls by isset($foo[3])
+- improvement Smarty_Internal_Utility::clearCompiledTemplate() removed redundant strlen()s
+
+29.09.2011
+- improvement of Smarty_Internal_Config::loadConfigVars() dropped the in_array for index look up
+
+28.09.2011
+- bugfix on template functions called nocache calling other template functions
+
+27.09.2011
+- bugfix possible warning "attempt to modify property of non-object" in {section} (issue #34)
+- added chaining to Smarty_Internal_Data so $smarty->assign('a',1)->assign('b',2); is possible now
+- bugfix remove race condition when a custom resource did change timestamp during compilation
+- bugfix variable property did not work on objects variable in template
+- bugfix smarty_make_timestamp() failed to process DateTime objects properly
+- bugfix wrong resource could be used on compile check of custom resource
+
+26.09.2011
+- bugfix repeated calls to same subtemplate did not make use of cached template object
+
+24.09.2011
+- removed internal muteExpectedErrors() calls in favor of having the implementor call this once from his application
+- optimized muteExpectedErrors() to pass errors to the latest registered error handler, if appliccable
+- added compile_dir and cache_dir to list of muted directories
+- improvment better error message for undefined templates at {include}
+
+23.09.2011
+- remove unused properties
+- optimization use real function instead anonymous function for preg_replace_callback
+- bugfix a relative {include} in child template blocks failed
+- bugfix direct setting of $template_dir, $config_dir, $plugins_dir in __construct() of an
+ extended Smarty class created problems
+- bugfix error muting was not implemented for cache locking
+
+===== Smarty 3.1.1 =====
+22.09.2011
+- bugfix {foreachelse} does fail if {section} was nested inside {foreach}
+- bugfix debug.tpl did not display correctly when it was compiled with escape_html = true
+
+21.09.2011
+- bugfix look for mixed case plugin file names as in 3.0 if not found try all lowercase
+- added $error_muting to suppress error messages even for badly implemented error_handlers
+- optimized autoloader
+- reverted ./ and ../ handling in fetch() and display() - they're allowed again
+
+20.09.2011
+- bugfix removed debug echo output while compiling template inheritance
+- bugfix relative paths in $template_dir broke relative path resolving in {include "../foo.tpl"}
+- bugfix {include} did not work inside nested {block} tags
+- bugfix {assign} with scope root and global did not work in all cases
+
+19.09.2011
+- bugfix regression in Smarty_CacheReource_KeyValueStore introduced by r4261
+- bugfix output filter shall not run on included subtemplates
+
+18.09.2011
+- bugfix template caching did not care about file.tpl in different template_dir
+- bugfix {include $file} was broken when merge_compiled_incluges = true
+- bugfix {include} was broken when merge_compiled_incluges = true and same indluded template
+ was used in different main templates in one compilation run
+- bugfix for Smarty2 style compiler plugins on unnamed attribute passing like {tag $foo $bar}
+- bugfix debug.tpl did not display correctly when it was compiled with escape_html = true
+
+17.09.2011
+- bugfix lock_id for file resource would create invalid filepath
+- bugfix resource caching did not care about file.tpl in different template_dir
+
+===== Smarty 3.1.0 =====
+15/09/2011
+- optimization of {foreach}; call internal _count() method only when "total" or "last" {foreach} properties are used
+
+11/09/2011
+- added unregisterObject() method
+
+06/09/2011
+- bugfix isset() did not work in templates on config variables
+
+03/09/2011
+- bugfix createTemplate() must default to cache_id and compile_id of Smarty object
+- bugfix Smarty_CacheResource_KeyValueStore must include $source->uid in cache filepath to keep templates with same
+ name but different folders seperated
+- added cacheresource.apc.php example in demo folder
+
+02/09/2011
+- bugfix cache lock file must use absolute filepath
+
+01/09/2011
+- update of cache locking
+
+30/08/2011
+- added locking mechanism to CacheResource API (implemented with File and KeyValueStores)
+
+28/08/2011
+- bugfix clearCompileTemplate() did not work for specific template subfolder or resource
+
+27/08/2011
+- bugfix {$foo|bar+1} did create syntax error
+
+26/08/2011
+- bugfix when generating nocache code which contains double \
+- bugfix handle race condition if cache file was deleted between filemtime and include
+
+17/08/2011
+- bugfix CacheResource_Custom bad internal fetch() call
+
+15/08/2011
+- bugfix CacheResource would load content twice for KeyValueStore and Custom handlers
+
+06/08/2011
+- bugfix {include} with scope attribute could execute in wrong scope
+- optimization of compile_check processing
+
+03/08/2011
+- allow comment tags to comment {block} tags out in child templates
+
+26/07/2011
+- bugfix experimental getTags() method did not work
+
+24/07/2011
+- sure opened output buffers are closed on exception
+- bugfix {foreach} did not work on IteratorAggregate
+
+22/07/2011
+- clear internal caches on clearAllCache(), clearCache(), clearCompiledTemplate()
+
+21/07/2011
+- bugfix value changes of variable values assigned to Smarty object could not be seen on repeated $smarty->fetch() calls
+
+17/07/2011
+- bugfix {$smarty.block.child} did drop a notice at undefined child
+
+15/07/2011
+- bugfix individual cache_lifetime of {include} did not work correctly inside {block} tags
+- added caches for Smarty_Template_Source and Smarty_Template_Compiled to reduce I/O for multiple cache_id rendering
+
+14/07/2011
+- made Smarty::loadPlugin() respect the include_path if required
+
+13/07/2011
+- optimized internal file write functionality
+- bugfix PHP did eat line break on nocache sections
+- fixed typo of Smarty_Security properties $allowed_modifiers and $disabled_modifiers
+
+06/07/2011
+- bugfix variable modifier must run befor gereral filtering/escaping
+
+04/07/2011
+- bugfix use (?P) syntax at preg_match as some pcre libraries failed on (?)
+- some performance improvement when using generic getter/setter on template objects
+
+30/06/2011
+- bugfix generic getter/setter of Smarty properties used on template objects did throw exception
+- removed is_dir and is_readable checks from directory setters for better performance
+
+28/06/2011
+- added back support of php template resource as undocumented feature
+- bugfix automatic recompilation on version change could drop undefined index notice on old 3.0 cache and compiled files
+- update of README_3_1_DEV.txt and moved into the distribution folder
+- improvement show first characters of eval and string templates instead sha1 Uid in debug window
+
+===== Smarty 3.1-RC1 =====
+25/06/2011
+- revert change of 17/06/2011. $_smarty varibale removed. call loadPlugin() from inside plugin code if required
+- code cleanup, remove no longer used properties and methods
+- update of PHPdoc comments
+
+23/06/2011
+- bugfix {html_select_date} would not respect current time zone
+
+19/06/2011
+- added $errors argument to testInstall() functions to suppress output.
+- added plugin-file checks to testInstall()
+
+18/06/2011
+- bugfix mixed use of same subtemplate inline and not inline in same script could cause a warning during compilation
+
+17/06/2011
+- bugfix/change use $_smarty->loadPlugin() when loading nested depending plugins via loadPlugin
+- bugfix {include ... inline} within {block}...{/block} did fail
+
+16/06/2011
+- bugfix do not overwrite '$smarty' template variable when {include ... scope=parent} is called
+- bugfix complete empty inline subtemplates did fail
+
+15/06/2011
+- bugfix template variables where not accessable within inline subtemplates
+
+12/06/2011
+- bugfix removed unneeded merging of template variable when fetching includled subtemplates
+
+10/06/2011
+- made protected properties $template_dir, $plugins_dir, $cache_dir, $compile_dir, $config_dir accessible via magic methods
+
+09/06/2011
+- fix smarty security_policy issue in plugins {html_image} and {fetch}
+
+05/06/2011
+- update of SMARTY_VERSION
+- bugfix made getTags() working again
+
+04/06/2011
+- allow extends resource in file attribute of {extends} tag
+
+03/06/2011
+- added {setfilter} tag to set filters for variable output
+- added escape_html property to control autoescaping of variable output
+
+27/05/2011
+- added allowed/disabled tags and modifiers in security for sandboxing
+
+23/05/2011
+- added base64: and urlencode: arguments to eval and string resource types
+
+22/05/2011
+- made time-attribute of {html_select_date} and {html_select_time} accept arrays as defined by attributes prefix and field_array
+
+13/05/2011
+- remove setOption / getOption calls from SamrtyBC class
+
+02/05/2011
+- removed experimental setOption() getOption() methods
+- output returned content also on opening tag calls of block plugins
+- rewrite of default plugin handler
+- compile code of variable filters for better performance
+
+20/04/2011
+- allow {php} {include_php} tags and PHP_ALLOW handling only with the SmartyBC class
+- removed support of php template resource
+
+20/04/2011
+- added extendsall resource example
+- optimization of template variable access
+- optimization of subtemplate handling {include}
+- optimization of template class
+
+01/04/2011
+- bugfix quote handling in capitalize modifier
+
+28/03/2011
+- bugfix stripslashes() requried when using PCRE e-modifier
+
+04/03/2011
+- upgrade to new PHP_LexerGenerator version 0.4.0 for better performance
+
+27/02/2011
+- ignore .svn folders when clearing cache and compiled files
+- string resources do not need a modify check
+
+26/02/2011
+- replaced smarty_internal_wrapper by SmartyBC class
+- load utility functions as static methods instead through __call()
+- bugfix in extends resource when subresources are used
+- optimization of modify checks
+
+25/02/2011
+- use $smarty->error_unassigned to control NOTICE handling on unassigned variables
+
+21/02/2011
+- added new new compile_check mode COMPILECHECK_CACHEMISS
+- corrected new cloning behaviour of createTemplate()
+- do no longer store the compiler object as property in the compile_tag classes to avoid possible memory leaks
+ during compilation
+
+19/02/2011
+- optimizations on merge_compiled_includes handling
+- a couple of optimizations and bugfixes related to new resource structure
+
+17/02/2011
+- changed ./ and ../ behaviour
+
+14/02/2011
+- added {block ... hide} option to supress block if no child is defined
+
+13/02/2011
+- update handling of recursive subtemplate calls
+- bugfix replace $smarty->triggerError() by exception in smarty_internal_resource_extends.php
+
+12/02/2011
+- new class Smarty_Internal_TemplateBase with shared methods of Smarty and Template objects
+- optimizations of template processing
+- made register... methods permanet
+- code for default_plugin_handler
+- add automatic recompilation at version change
+
+04/02/2011
+- change in Smarty_CacheResource_Custom
+- bugfix cache_lifetime did not compile correctly at {include} after last update
+- moved isCached processing into CacheResource class
+- bugfix new CacheResource API did not work with disabled compile_check
+
+03/02/2011
+- handle template content as function to improve speed on multiple calls of same subtemplate and isCached()/display() calls
+- bugfixes and improvents in the new resource API
+- optimizations of template class code
+
+25/01/2011
+- optimized function html_select_time
+
+22/01/2011
+- added Smarty::$use_include_path configuration directive for Resource API
+
+21/01/2011
+- optimized function html_select_date
+
+19/01/2011
+- optimized outputfilter trimwhitespace
+
+18/01/2011
+- bugfix Config to use Smarty_Resource to fetch sources
+- optimized Smarty_Security's isTrustedDir() and isTrustedPHPDir()
+
+17/01/2011
+- bugfix HTTP headers for CGI SAPIs
+
+16/01/2011
+- optimized internals of Smarty_Resource and Smarty_CacheResource
+
+14/01/2011
+- added modifiercompiler escape to improve performance of escaping html, htmlall, url, urlpathinfo, quotes, javascript
+- added support to choose template_dir to load from: [index]filename.tpl
+
+12/01/2011
+- added unencode modifier to revert results of encode modifier
+- added to_charset and from_charset modifier for character encoding
+
+11/01/2011
+- added SMARTY_MBSTRING to generalize MBString detection
+- added argument $lc_rest to modifier.capitalize to lower-case anything but the first character of a word
+- changed strip modifier to consider unicode white-space, too
+- changed wordwrap modifier to accept UTF-8 strings
+- changed count_sentences modifier to consider unicode characters and treat sequences delimited by ? and ! as sentences, too
+- added argument $double_encode to modifier.escape (applies to html and htmlall only)
+- changed escape modifier to be UTF-8 compliant
+- changed textformat block to be UTF-8 compliant
+- optimized performance of mailto function
+- fixed spacify modifier so characters are not prepended and appended, made it unicode compatible
+- fixed truncate modifier to properly use mb_string if possible
+- removed UTF-8 frenzy from count_characters modifier
+- fixed count_words modifier to treat "hello-world" as a single word like str_count_words() does
+- removed UTF-8 frenzy from upper modifier
+- removed UTF-8 frenzy from lower modifier
+
+01/01/2011
+- optimize smarty_modified_escape for hex, hexentity, decentity.
+
+28/12/2010
+- changed $tpl_vars, $config_vars and $parent to belong to Smarty_Internal_Data
+- added Smarty::registerCacheResource() for dynamic cache resource object registration
+
+27/12/2010
+- added Smarty_CacheResource API and refactored existing cache resources accordingly
+- added Smarty_CacheResource_Custom and Smarty_CacheResource_Mysql
+
+26/12/2010
+- added Smarty_Resource API and refactored existing resources accordingly
+- added Smarty_Resource_Custom and Smarty_Resource_Mysql
+- bugfix Smarty::createTemplate() to return properly cloned template instances
+
+24/12/2010
+- optimize smarty_function_escape_special_chars() for PHP >= 5.2.3
+
+===== SVN 3.0 trunk =====
+14/05/2011
+- bugfix error handling at stream resources
+
+13/05/2011
+- bugfix condition starting with "-" did fail at {if} and {while} tags
+
+22/04/2011
+- bugfix allow only fixed string as file attribute at {extends} tag
+
+01/04/2011
+- bugfix do not run filters and default modifier when displaying the debug template
+- bugfix of embedded double quotes within multi line strings (""")
+
+29/03/2011
+- bugfix on error message in smarty_internal_compile_block.php
+- bugfix mb handling in strip modifier
+- bugfix for Smarty2 style registered compiler function on unnamed attribute passing like {tag $foo $bar}
+
+17/03/2011
+- bugfix on default {function} parameters when {function} was used in nocache sections
+- bugfix on compiler object destruction. compiler_object property was by mistake unset.
+
+09/03/2011
+-bugfix a variable filter should run before modifers on an output tag (see change of 23/07/2010)
+
+08/03/2011
+- bugfix loading config file without section should load only defaults
+
+03/03/2011
+- bugfix "smarty" template variable was not recreated when cached templated had expired
+- bugfix internal rendered_content must be cleared after subtemplate was included
+
+01/03/2011
+- bugfix replace modifier did not work in 3.0.7 on systems without multibyte support
+- bugfix {$smarty.template} could return in 3.0.7 parent template name instead of
+ child name when it needed to compile
+
+25/02/2011
+- bugfix for Smarty2 style compiler plugins on unnamed attribute passing like {tag $foo $bar}
+
+24/02/2011
+- bugfix $smarty->clearCache('some.tpl') did by mistake cache the template object
+
+18/02/2011
+- bugfix removed possible race condition when isCached() was called for an individually cached subtemplate
+- bugfix force default debug.tpl to be loaded by the file resource
+
+17/02/2011
+-improvement not to delete files starting with '.' from cache and template_c folders on clearCompiledTemplate() and clearCache()
+
+16/02/2011
+-fixed typo in exception message of Smarty_Internal_Template
+-improvement allow leading spaces on } tag closing if auto_literal is enabled
+
+13/02/2011
+- bufix replace $smarty->triggerError() by exception
+- removed obsolete {popup_init..} plugin from demo templates
+- bugfix replace $smarty->triggerError() by exception in smarty_internal_resource_extends.php
+
+===== Smarty 3.0.7 =====
+09/02/2011
+- patched vulnerability when using {$smarty.template}
+
+01/02/2011
+- removed assert() from config and template parser
+
+31/01/2011
+- bugfix the lexer/parser did fail on special characters like VT
+
+16/01/2011
+-bugfix of ArrayAccess object handling in internal _count() method
+-bugfix of Iterator object handling in internal _count() method
+
+14/01/2011
+-bugfix removed memory leak while processing compileAllTemplates
+
+12/01/2011
+- bugfix in {if} and {while} tag compiler when using assignments as condition and nocache mode
+
+10/01/2011
+- bugfix when using {$smarty.block.child} and name of {block} was in double quoted string
+- bugfix updateParentVariables() was called twice when leaving {include} processing
+
+- bugfix mb_str_replace in replace and escape modifiers work with utf8
+
+31/12/2010
+- bugfix dynamic configuration of $debugging_crtl did not work
+- bugfix default value of $config_read_hidden changed to false
+- bugfix format of attribute array on compiler plugins
+- bugfix getTemplateVars() could return value from wrong scope
+
+28/12/2010
+- bugfix multiple {append} tags failed to compile.
+
+22/12/2010
+- update do not clone the Smarty object an internal createTemplate() calls to increase performance
+
+21/12/2010
+- update html_options to support class and id attrs
+
+17/12/2010
+- bugfix added missing support of $cache_attrs for registered plugins
+
+15/12/2010
+- bugfix assignment as condition in {while} did drop an E_NOTICE
+
+14/12/2010
+- bugfix when passing an array as default parameter at {function} tag
+
+13/12/2010
+- bugfix {$smarty.template} in child template did not return right content
+- bugfix Smarty3 did not search the PHP include_path for template files
+
+===== Smarty 3.0.6 =====
+
+12/12/2010
+- bugfix fixed typo regarding yesterdays change to allow streamWrapper
+
+11/12/2010
+- bugfix nested block tags in template inheritance child templates did not work correctly
+- bugfix {$smarty.current_dir} in child template did not point to dir of child template
+- bugfix changed code when writing temporary compiled files to allow stream_wrapper
+
+06/12/2010
+- bugfix getTemplateVars() should return 'null' instead dropping E_NOTICE on an unassigned variable
+
+05/12/2010
+- bugfix missing declaration of $smarty in Smarty class
+- bugfix empty($foo) in {if} did drop a notice when $foo was not assigned
+
+01/12/2010
+- improvement of {debug} tag output
+
+27/11/2010
+-change run output filter before cache file is written. (same as in Smarty2)
+
+24/11/2011
+-bugfix on parser at !$foo|modifier
+-change parser logic when assignments used as condition in {if] and {while} to allow assign to array element
+
+23/11/2011
+-bugfix allow integer as attribute name in plugin calls
+-change trimm whitespace from error message, removed long list of expected tokens
+
+22/11/2010
+- bugfix on template inheritance when an {extends} tag was inserted by a prefilter
+- added error message for illegal variable file attributes at {extends...} tags
+
+===== Smarty 3.0.5 =====
+
+
+19/11/2010
+- bugfix on block plugins with modifiers
+
+18/11/2010
+- change on handling of unassigned template variable -- default will drop E_NOTICE
+- bugfix on Smarty2 wrapper load_filter() did not work
+
+17/11/2010
+- bugfix on {call} with variable function name
+- bugfix on {block} if name did contain '-'
+- bugfix in function.fetch.php , referece to undefined $smarty
+
+16/11/2010
+- bugfix whitespace in front of "fetch()/display() have been used in plugins
+ (introduced with 3.0.2)
+- code cleanup
+
+===== Smarty 3.0.3 =====
+
+13/11/2010
+- bugfix on {debug}
+- reverted location of loadPlugin() to Smarty class
+- fixed comments in plugins
+- fixed internal_config (removed unwanted code line)
+- improvement remove last linebreak from {function} definition
+
+===== Smarty 3.0.2 =====
+
+12/11/2010
+- reactivated $error_reporting property handling
+- fixed typo in compile_continue
+- fixed security in {fetch} plugin
+- changed back plugin parameters to two. second is template object
+ with transparent access to Smarty object
+- fixed {config_load} scoping form compile time to run time
+
+===== Smarty 3.0.0 =====
+
+
+
+11/11/2010
+- major update including some API changes
+
+10/11/2010
+- observe compile_id also for config files
+
+09/11/2010
+-bugfix on complex expressions as start value for {for} tag
+request_use_auto_globals
+04/11/2010
+- bugfix do not allow access of dynamic and private object members of assigned objects when
+ security is enabled.
+
+01/11/2010
+- bugfix related to E_NOTICE change. {if empty($foo)} did fail when $foo contained a string
+
+28/10/2010
+- bugfix on compiling modifiers within $smarty special vars like {$smarty.post.{$foo|lower}}
+
+27/10/2010
+- bugfix default parameter values did not work for template functions included with {include}
+
+25/10/2010
+- bugfix for E_NOTICE change, array elements did not work as modifier parameter
+
+20/10/2010
+- bugfix for the E_NOTICE change
+
+19/10/2010
+- change Smarty does no longer mask out E_NOTICE by default during template processing
+
+13/10/2010
+- bugfix removed ambiguity between ternary and stream variable in template syntax
+- bugfix use caching properties of template instead of smarty object when compiling child {block}
+- bugfix {*block}...{/block*} did throw an exception in template inheritance
+- bugfix on template inheritance using nested eval or string resource in {extends} tags
+- bugfix on output buffer handling in isCached() method
+
+===== RC4 =====
+
+01/10/2010
+- added {break} and {continue} tags for flow control of {foreach},{section},{for} and {while} loops
+- change of 'string' resource. It's no longer evaluated and compiled files are now stored
+- new 'eval' resource which evaluates a template without saving the compiled file
+- change in isCached() method to allow multiple calls for the same template
+
+25/09/2010
+- bugfix on some compiling modifiers
+
+24/09/2010
+- bugfix merge_compiled_includes flag was not restored correctly in {block} tag
+
+22/09/2010
+- bugfix on default modifier
+
+18/09/2010
+- bugfix untility compileAllConfig() did not create sha1 code for compiled template file names if template_dir was defined with no trailing DS
+- bugfix on templateExists() for extends resource
+
+17/09/2010
+- bugfix {$smarty.template} and {$smarty.current_dir} did not compile correctly within {block} tags
+- bugfix corrected error message on missing template files in extends resource
+- bugfix untility compileAllTemplates() did not create sha1 code for compiled template file names if template_dir was defined with no trailing DS
+
+16/09/2010
+- bugfix when a doublequoted modifier parameter did contain Smarty tags and ':'
+
+15/09/2010
+- bugfix resolving conflict between '<%'/'%>' as custom Smarty delimiter and ASP tags
+- use ucfirst for resource name on internal resource class names
+
+12/09/2010
+- bugfix for change of 08/09/2010 (final {block} tags in subtemplates did not produce correct results)
+
+10/09/2010
+- bugfix for change of 08/09/2010 (final {block} tags in subtemplates did not produce correct results)
+
+08/09/2010
+- allow multiple template inheritance branches starting in subtemplates
+
+07/09/2010
+- bugfix {counter} and {cycle} plugin assigned result to smarty variable not in local(template) scope
+- bugfix templates containing just {strip} {/strip} tags did produce an error
+
+
+23/08/2010
+- fixed E_STRICT errors for uninitialized variables
+
+22/08/2010
+- added attribute cache_id to {include} tag
+
+13/08/2010
+- remove exception_handler property from Smarty class
+- added Smarty's own exceptions SmartyException and SmartyCompilerException
+
+09/08/2010
+- bugfix on modifier with doublequoted strings as parameter containing embedded tags
+
+06/08/2010
+- bugfix when cascading some modifier like |strip|strip_tags modifier
+
+05/08/2010
+- added plugin type modifiercompiler to produce compiled modifier code
+- changed standard modifier plugins to the compiling versions whenever possible
+- bugfix in nocache sections {include} must not cache the subtemplate
+
+02/08/2010
+- bugfix strip did not work correctly in conjunction with comment lines
+
+31/07/2010
+- bugfix on nocache attribute at {assign} and {append}
+
+30/07/2010
+- bugfix passing scope attributes in doublequoted strings did not work at {include} {assign} and {append}
+
+25/07/2010
+- another bugfix of change from 23/07/2010 when compiling modifer
+
+24/07/2010
+- bugfix of change from 23/07/2010 when compiling modifer
+
+23/07/2010
+- changed execution order. A variable filter does now run before modifiers on output of variables
+- bugfix use always { and } as delimiter for debug.tpl
+
+
+22/07/2010
+- bugfix in templateExists() method
+
+20/07/2010
+- fixed handling of { strip } tag with whitespaces
+
+15/07/2010
+- bufix {$smarty.template} does include now the relative path, not just filename
+
+===== RC3 =====
+
+
+
+
+15/07/2010
+- make the date_format modifier work also on objects of the DateTime class
+- implementation of parsetrees in the parser to close security holes and remove unwanted empty line in HTML output
+
+08/07/2010
+- bugfix on assigning multidimensional arrays within templates
+- corrected bugfix for truncate modifier
+
+07/07/2010
+- bugfix the truncate modifier needs to check if the string is utf-8 encoded or not
+- bugfix support of script files relative to trusted_dir
+
+06/07/2010
+- create exception on recursive {extends} calls
+- fixed reported line number at "unexpected closing tag " exception
+- bugfix on escape:'mail' modifier
+- drop exception if 'item' variable is equal 'from' variable in {foreach} tag
+
+01/07/2010
+- removed call_user_func_array calls for optimization of compiled code when using registered modifiers and plugins
+
+25/06/2010
+- bugfix escaping " when block tags are used within doublequoted strings
+
+24/06/2010
+- replace internal get_time() calls with standard PHP5 microtime(true) calls in Smarty_Internal_Utility
+- added $smarty->register->templateClass() and $smarty->unregister->templateClass() methods for supporting static classes with namespace
+
+
+22/06/2010
+- allow spaces between typecast and value in template syntax
+- bugfix get correct count of traversables in {foreach} tag
+
+21/06/2010
+- removed use of PHP shortags SMARTY_PHP_PASSTHRU mode
+- improved speed of cache->clear() when a compile_id was specified and use_sub_dirs is true
+
+20/06/2010
+- replace internal get_time() calls with standard PHP5 microtime(true) calls
+- closed security hole when php.ini asp_tags = on
+
+18/06/2010
+- added __toString method to the Smarty_Variable class
+
+
+14/06/2010
+- make handling of Smarty comments followed by newline BC to Smarty2
+
+
+===== RC2 =====
+
+
+
+13/06/2010
+- bugfix Smarty3 did not handle hexadecimals like 0x0F as numerical value
+- bugifx Smarty3 did not accept numerical constants like .1 or 2. (without a leading or trailing digit)
+
+11/06/2010
+- bugfix the lexer did fail on larger {literal} ... {/literal} sections
+
+03/06/2010
+- bugfix on calling template functions like Smarty tags
+
+01/06/2010
+- bugfix on template functions used with template inheritance
+- removed /* vim: set expandtab: */ comments
+- bugfix of auto literal problem introduce with fix of 31/05/2010
+
+31/05/2010
+- bugfix the parser did not allow some smarty variables with special name like $for, $if, $else and others.
+
+27/05/2010
+- bugfix on object chaining using variable properties
+- make scope of {counter} and {cycle} tags again global as in Smarty2
+
+26/05/2010
+- bugfix removed decrepated register_resource call in smarty_internal_template.php
+
+25/05/2010
+- rewrite of template function handling to improve speed
+- bugfix on file dependency when merge_compiled_includes = true
+
+
+16/05/2010
+- bugfix when passing parameter with numeric name like {foo 1='bar' 2='blar'}
+
+14/05/2010
+- bugfix compile new config files if compile_check and force_compile = false
+- added variable static classes names to template syntax
+
+11/05/2010
+- bugfix make sure that the cache resource is loaded in all conditions when template methods getCached... are called externally
+- reverted the change 0f 30/04/2010. With the exception of forward references template functions can be again called by a standard tag.
+
+10/05/2010
+- bugfix on {foreach} and {for} optimizations of 27/04/2010
+
+09/05/2010
+- update of template and config file parser because of minor parser generator bugs
+
+07/05/2010
+- bugfix on {insert}
+
+06/05/2010
+- bugfix when merging compiled templates and objects are passed as parameter of the {include} tag
+
+05/05/2010
+- bugfix on {insert} to cache parameter
+- implementation of $smarty->default_modifiers as in Smarty2
+- bugfix on getTemplateVars method
+
+01/05/2010
+- bugfix on handling of variable method names at object chaning
+
+30/04/2010
+- bugfix when comparing timestamps in sysplugins/smarty_internal_config.php
+- work around of a substr_compare bug in older PHP5 versions
+- bugfix on template inheritance for tag names starting with "block"
+- bugfix on {function} tag with name attribute in doublequoted strings
+- fix to make calling of template functions unambiguously by madatory usage of the {call} tag
+
+===== RC1 =====
+
+27/04/2010
+- change default of $debugging_ctrl to 'NONE'
+- optimization of compiled code of {foreach} and {for} loops
+- change of compiler for config variables
+
+27/04/2010
+- bugfix in $smarty->cache->clear() method. (do not cache template object)
+
+
+17/04/2010
+- security fix in {math} plugin
+
+
+12/04/2010
+- bugfix in smarty_internal_templatecompilerbase (overloaded property)
+- removed parser restrictions in using true,false and null as ID
+
+07/04/2010
+- bugfix typo in smarty_internal_templatecompilerbase
+
+31/03/2010
+- compile locking by touching old compiled files to avoid concurrent compilations
+
+29/03/2010
+- bugfix allow array definitions as modifier parameter
+- bugfix observe compile_check property when loading config files
+- added the template object as third filter parameter
+
+25/03/2010
+- change of utility->compileAllTemplates() log messages
+- bugfix on nocache code in {function} tags
+- new method utility->compileAllConfig() to compile all config files
+
+24/03/2010
+- bugfix on register->modifier() error messages
+
+23/03/2010
+- bugfix on template inheritance when calling multiple child/parent relations
+- bugfix on caching mode SMARTY_CACHING_LIFETIME_SAVED and cache_lifetime = 0
+
+22/03/2010
+- bugfix make directory separator operating system independend in compileAllTemplates()
+
+21/03/2010
+- removed unused code in compileAllTemplates()
+
+19/03/2010
+- bugfix for multiple {/block} tags on same line
+
+17/03/2010
+- bugfix make $smarty->cache->clear() function independent from caching status
+
+16/03/2010
+- bugfix on assign attribute at registered template objects
+- make handling of modifiers on expression BC to Smarty2
+
+15/03/2010
+- bugfix on block plugin calls
+
+11/03/2010
+- changed parsing of back to Smarty2 behaviour
+
+08/03/2010
+- bugfix on uninitialized properties in smarty_internal_template
+- bugfix on $smarty->disableSecurity()
+
+04/03/2010
+- bugfix allow uppercase chars in registered resource names
+- bugfix on accessing chained objects of static classes
+
+01/03/2010
+- bugfix on nocache code in {block} tags if child template was included by {include}
+
+27/02/2010
+- allow block tags inside double quoted string
+
+26/02/2010
+- cache modified check implemented
+- support of access to a class constant from an object (since PHP 5.3)
+
+24/02/2010
+- bugfix on expressions in doublequoted string enclosed in backticks
+- added security property $static_classes for static class security
+
+18/02/2010
+- bugfix on parsing Smarty tags inside
+- bugfix on truncate modifier
+
+17/02/2010
+- removed restriction that modifiers did require surrounding parenthesis in some cases
+- added {$smarty.block.child} special variable for template inheritance
+
+16/02/2010
+- bugfix on tags for all php_handling modes
+- bugfix on parameter of variablefilter.htmlspecialchars.php plugin
+
+14/02/2010
+- added missing _plugins property in smarty.class.php
+- bugfix $smarty.const... inside doublequoted strings and backticks was compiled into wrong PHP code
+
+12/02/2010
+- bugfix on nested {block} tags
+- changed Smarty special variable $smarty.parent to $smarty.block.parent
+- added support of nested {bock} tags
+
+10/02/2010
+- avoid possible notice on $smarty->cache->clear(...), $smarty->clear_cache(....)
+- allow Smarty tags inside tags in SMARTY_PHP_QUOTE and SMARTY_PHP_PASSTHRU mode
+- bugfix at new "for" syntax like {for $x=1 to 10 step 2}
+
+09/02/2010
+- added $smarty->_tag_stack for tracing block tag hierarchy
+
+08/02/2010
+- bugfix use template fullpath at §smarty->cache->clear(...), $smarty->clear_cache(....)
+- bugfix of cache filename on extended templates when force_compile=true
+
+07/02/2010
+- bugfix on changes of 05/02/2010
+- preserve line endings type form template source
+- API changes (see README file)
+
+05/02/2010
+- bugfix on modifier and block plugins with same name
+
+02/02/2010
+- retaining newlines at registered functions and function plugins
+
+01/25/2010
+- bugfix cache resource was not loaded when caching was globally off but enabled at a template object
+- added test that $_SERVER['SCRIPT_NAME'] does exist in Smarty.class.php
+
+01/22/2010
+- new method $smarty->createData([$parent]) for creating a data object (required for bugfixes below)
+- bugfix config_load() method now works also on a data object
+- bugfix get_config_vars() method now works also on a data and template objects
+- bugfix clear_config() method now works also on a data and template objects
+
+01/19/2010
+- bugfix on plugins if same plugin was called from a nocache section first and later from a cached section
+
+
+###beta 7###
+
+
+01/17/2010
+- bugfix on $smarty.const... in double quoted strings
+
+01/16/2010
+- internal change of config file lexer/parser on handling of section names
+- bugfix on registered objects (format parameter of register_object was not handled correctly)
+
+01/14/2010
+- bugfix on backslash within single quoted strings
+- bugfix allow absolute filepath for config files
+- bugfix on special Smarty variable $smarty.cookies
+- revert handling of newline on no output tags like {if...}
+- allow special characters in config file section names for Smarty2 BC
+
+01/13/2010
+- bugfix on {if} tags
+
+01/12/2010
+- changed back modifer handling in parser. Some restrictions still apply:
+ if modifiers are used in side {if...} expression or in mathematical expressions
+ parentheses must be used.
+- bugfix the {function..} tag did not accept the name attribute in double quotes
+- closed possible security hole at tags
+- bugfix of config file parser on large config files
+
+
+###beta 6####
+
+01/11/2010
+- added \n to the compiled code of the {if},{else},{elseif},{/if} tags to get output of newlines as expected by the template source
+- added missing support of insert plugins
+- added optional nocache attribute to {block} tags in parent template
+- updated handling supporting now heredocs and newdocs. (thanks to Thue Jnaus Kristensen)
+
+01/09/2010
+- bugfix on nocache {block} tags in parent templates
+
+01/08/2010
+- bugfix on variable filters. filter/nofilter attributes did not work on output statements
+
+01/07/2010
+- bugfix on file dependency at template inheritance
+- bugfix on nocache code at template inheritance
+
+01/06/2010
+- fixed typo in smarty_internal_resource_registered
+- bugfix for custom delimiter at extends resource and {extends} tag
+
+01/05/2010
+- bugfix sha1() calculations at extends resource and some general improvments on sha1() handling
+
+
+01/03/2010
+- internal change on building cache files
+
+01/02/2010
+- update cached_timestamp at the template object after cache file is written to avoid possible side effects
+- use internally always SMARTY_CACHING_LIFETIME_* constants
+
+01/01/2010
+- bugfix for obtaining plugins which must be included (related to change of 12/30/2009)
+- bugfix for {php} tag (trow an exception if allow_php_tag = false)
+
+12/31/2009
+- optimization of generated code for doublequoted strings containing variables
+- rewrite of {function} tag handling
+ - can now be declared in an external subtemplate
+ - can contain nocache sections (nocache_hash handling)
+ - can be called in noccache sections (nocache_hash handling)
+ - new {call..} tag to call template functions with a variable name {call name=$foo}
+- fixed nocache_hash handling in merged compiled templates
+
+12/30/2009
+- bugfix for plugins defined in the script as smarty_function_foo
+
+12/29/2009
+- use sha1() for filepath encoding
+- updates on nocache_hash handling
+- internal change on merging some data
+- fixed cache filename for custom resources
+
+12/28/2009
+- update for security fixes
+- make modifier plugins always trusted
+- fixed bug loading modifiers in child template at template inheritance
+
+12/27/2009
+--- this is a major update with a couple of internal changes ---
+- new config file lexer/parser (thanks to Thue Jnaus Kristensen)
+- template lexer/parser fixes for PHP and {literal} handing (thanks to Thue Jnaus Kristensen)
+- fix on registered plugins with different type but same name
+- rewrite of plugin handling (optimized execution speed)
+- closed a security hole regarding PHP code injection into cache files
+- fixed bug in clear cache handling
+- Renamed a couple of internal classes
+- code cleanup for merging compiled templates
+- couple of runtime optimizations (still not all done)
+- update of getCachedTimestamp()
+- fixed bug on modifier plugins at nocache output
+
+12/19/2009
+- bugfix on comment lines in config files
+
+12/17/2009
+- bugfix of parent/global variable update at included/merged subtemplates
+- encode final template filepath into filename of compiled and cached files
+- fixed {strip} handling in auto literals
+
+12/16/2009
+- update of changelog
+- added {include file='foo.tpl' inline} inline option to merge compiled code of subtemplate into the calling template
+
+12/14/2009
+- fixed sideefect of last modification (objects in array index did not work anymore)
+
+12/13/2009
+- allow boolean negation ("!") as operator on variables outside {if} tag
+
+12/12/2009
+- bugfix on single quotes inside {function} tag
+- fix short append/prepend attributes in {block} tags
+
+12/11/2009
+- bugfix on clear_compiled_tpl (avoid possible warning)
+
+12/10/2009
+- bugfix on {function} tags and template inheritance
+
+12/05/2009
+- fixed problem when a cached file was fetched several times
+- removed unneeded lexer code
+
+12/04/2009
+- added max attribute to for loop
+- added security mode allow_super_globals
+
+12/03/2009
+- template inheritance: child templates can now call functions defined by the {function} tag in the parent template
+- added {for $foo = 1 to 5 step 2} syntax
+- bugfix for {$foo.$x.$y.$z}
+
+12/01/2009
+- fixed parsing of names of special formated tags like if,elseif,while,for,foreach
+- removed direct access to constants in templates because of some syntax problems
+- removed cache resource plugin for mysql from the distribution
+- replaced most hard errors (exceptions) by softerrors(trigger_error) in plugins
+- use $template_class property for template class name when compiling {include},{eval} and {extends} tags
+
+11/30/2009
+- map 'true' to SMARTY_CACHING_LIFETIME_CURRENT for the $smarty->caching parameter
+- allow {function} tags within {block} tags
+
+11/28/2009
+- ignore compile_id at debug template
+- added direct access to constants in templates
+- some lexer/parser optimizations
+
+11/27/2009
+- added cache resource MYSQL plugin
+
+11/26/2009
+- bugfix on nested doublequoted strings
+- correct line number on unknown tag error message
+- changed {include} compiled code
+- fix on checking dynamic varibales with error_unassigned = true
+
+11/25/2009
+- allow the following writing for boolean: true, TRUE, True, false, FALSE, False
+- {strip} tag functionality rewritten
+
+11/24/2009
+- bugfix for $smarty->config_overwrite = false
+
+11/23/2009
+- suppress warnings on unlink caused by race conditions
+- correct line number on unknown tag error message
+
+------- beta 5
+11/23/2009
+- fixed configfile parser for text starting with a numeric char
+- the default_template_handler_func may now return a filepath to a template source
+
+11/20/2009
+- bugfix for empty config files
+- convert timestamps of registered resources to integer
+
+11/19/2009
+- compiled templates are no longer touched with the filemtime of template source
+
+11/18/2009
+- allow integer as attribute name in plugin calls
+
+------- beta 4
+11/18/2009
+- observe umask settings when setting file permissions
+- avoide unneeded cache file creation for subtemplates which did occur in some situations
+- make $smarty->_current_file available during compilation for Smarty2 BC
+
+11/17/2009
+- sanitize compile_id and cache_id (replace illegal chars with _)
+- use _dir_perms and _file_perms properties at file creation
+- new constant SMARTY_RESOURCE_DATE_FORMAT (default '%b %e, %Y') which is used as default format in modifier date_format
+- added {foreach $array as $key=>$value} syntax
+- renamed extend tag and resource to extends: {extends file='foo.tol'} , $smarty->display('extends:foo.tpl|bar.tpl);
+- bugfix cycle plugin
+
+11/15/2009
+- lexer/parser optimizations on quoted strings
+
+11/14/2009
+- bugfix on merging compiled templates when source files got removed or renamed.
+- bugfix modifiers on registered object tags
+- fixed locaion where outputfilters are running
+- fixed config file definitions at EOF
+- fix on merging compiled templates with nocache sections in nocache includes
+- parser could run into a PHP error on wrong file attribute
+
+11/12/2009
+- fixed variable filenames in {include_php} and {insert}
+- added scope to Smarty variables in the {block} tag compiler
+- fix on nocache code in child {block} tags
+
+11/11/2009
+- fixed {foreachelse}, {forelse}, {sectionelse} compiled code at nocache variables
+- removed checking for reserved variables
+- changed debugging handling
+
+11/10/2009
+- fixed preg_qoute on delimiters
+
+11/09/2009
+- lexer/parser bugfix
+- new SMARTY_SPL_AUTOLOAD constant to control the autoloader option
+- bugfix for {function} block tags in included templates
+
+11/08/2009
+- fixed alphanumeric array index
+- bugfix on complex double quoted strings
+
+11/05/2009
+- config_load method can now be called on data and template objects
+
+11/04/2009
+- added typecasting support for template variables
+- bugfix on complex indexed special Smarty variables
+
+11/03/2009
+- fixed parser error on objects with special smarty vars
+- fixed file dependency for {incude} inside {block} tag
+- fixed not compiling on non existing compiled templates when compile_check = false
+- renamed function names of autoloaded Smarty methods to Smarty_Method_....
+- new security_class property (default is Smarty_Security)
+
+11/02/2009
+- added neq,lte,gte,mod as aliases to if conditions
+- throw exception on illegal Smarty() constructor calls
+
+10/31/2009
+- change of filenames in sysplugins folder for internal spl_autoload function
+- lexer/parser changed for increased compilation speed
+
+10/27/2009
+- fixed missing quotes in include_php.php
+
+10/27/2009
+- fixed typo in method.register_resource
+- pass {} through as literal
+
+10/26/2009
+- merge only compiled subtemplates into the compiled code of the main template
+
+10/24/2009
+- fixed nocache vars at internal block tags
+- fixed merging of recursive includes
+
+10/23/2009
+- fixed nocache var problem
+
+10/22/2009
+- fix trimwhitespace outputfilter parameter
+
+10/21/2009
+- added {$foo++}{$foo--} syntax
+- buxfix changed PHP "if (..):" to "if (..){" because of possible bad code when concenating PHP tags
+- autoload Smarty internal classes
+- fixed file dependency for config files
+- some code optimizations
+- fixed function definitions on some autoloaded methods
+- fixed nocache variable inside if condition of {if} tag
+
+10/20/2009
+- check at compile time for variable filter to improve rendering speed if no filter is used
+- fixed bug at combination of {elseif} tag and {...} in double quoted strings of static class parameter
+
+10/19/2009
+- fixed compiled template merging on variable double quoted strings as name
+- fixed bug in caching mode 2 and cache_lifetime -1
+- fixed modifier support on block tags
+
+10/17/2009
+- remove ?>\n'bar','foo2'=>'blar');
+ $smarty->display('my.tpl',$data);
+
+09/29/2009
+- changed {php} tag handling
+- removed support of Smarty::instance()
+- removed support of PHP resource type
+- improved execution speed of {foreach} tags
+- fixed bug in {section} tag
+
+09/23/2009
+- improvements and bugfix on {include} tag handling
+NOTICE: existing compiled template and cache files must be deleted
+
+09/19/2009
+- replace internal "eval()" calls by "include" during rendering process
+- speed improvment for templates which have included subtemplates
+ the compiled code of included templates is merged into the compiled code of the parent template
+- added logical operator "xor" for {if} tag
+- changed parameter ordering for Smarty2 BC
+ fetch($template, $cache_id = null, $compile_id = null, $parent = null)
+ display($template, $cache_id = null, $compile_id = null, $parent = null)
+ createTemplate($template, $cache_id = null, $compile_id = null, $parent = null)
+- property resource_char_set is now replaced by constant SMARTY_RESOURCE_CHAR_SET
+- fixed handling of classes in registered blocks
+- speed improvement of lexer on text sections
+
+09/01/2009
+- dropped nl2br as plugin
+- added '<>' as comparission operator in {if} tags
+- cached caching_lifetime property to cache_liftime for backward compatibility with Smarty2.
+ {include} optional attribute is also now cache_lifetime
+- fixed trigger_error method (moved into Smarty class)
+- version is now Beta!!!
+
+
+08/30/2009
+- some speed optimizations on loading internal plugins
+
+
+08/29/2009
+- implemented caching of registered Resources
+- new property 'auto_literal'. if true(default) '{ ' and ' }' interpreted as literal, not as Smarty delimiter
+
+
+08/28/2009
+- Fix on line breaks inside {if} tags
+
+08/26/2009
+- implemented registered resources as in Smarty2. NOTE: caching does not work yet
+- new property 'force_cache'. if true it forces the creation of a new cache file
+- fixed modifiers on arrays
+- some speed optimization on loading internal classes
+
+
+08/24/2009
+- fixed typo in lexer definition for '!==' operator
+- bugfix - the ouput of plugins was not cached
+- added global variable SCRIPT_NAME
+
+08/21/2009
+- fixed problems whitespace in conjuction with custom delimiters
+- Smarty tags can now be used as value anywhere
+
+08/18/2009
+- definition of template class name moded in internal.templatebase.php
+- whitespace parser changes
+
+08/12/2009
+- fixed parser problems
+
+08/11/2009
+- fixed parser problems with custom delimiter
+
+08/10/2009
+- update of mb support in plugins
+
+
+08/09/2009
+- fixed problems with doublequoted strings at name attribute of {block} tag
+- bugfix at scope attribute of {append} tag
+
+08/08/2009
+- removed all internal calls of Smarty::instance()
+- fixed code in double quoted strings
+
+08/05/2009
+- bugfix mb_string support
+- bugfix of \n.\t etc in double quoted strings
+
+07/29/2009
+- added syntax for variable config vars like #$foo#
+
+07/28/2009
+- fixed parsing of $smarty.session vars containing objects
+
+07/22/2009
+- fix of "$" handling in double quoted strings
+
+07/21/2009
+- fix that {$smarty.current_dir} return correct value within {block} tags.
+
+07/20/2009
+- drop error message on unmatched {block} {/block} pairs
+
+07/01/2009
+- fixed smarty_function_html_options call in plugin function.html_select_date.php (missing ,)
+
+06/24/2009
+- fixed smarty_function_html_options call in plugin function.html_select_date.php
+
+06/22/2009
+- fix on \n and spaces inside smarty tags
+- removed request_use_auto_globals propert as it is no longer needed because Smarty 3 will always run under PHP 5
+
+
+06/18/2009
+- fixed compilation of block plugins when caching enabled
+- added $smarty.current_dir which returns the current working directory
+
+06/14/2009
+- fixed array access on super globals
+- allow smarty tags within xml tags
+
+06/13/2009
+- bugfix at extend resource: create unique files for compiled template and cache for each combination of template files
+- update extend resource to handle appen and prepend block attributes
+- instantiate classes of plugins instead of calling them static
+
+06/03/2009
+- fixed repeat at block plugins
+
+05/25/2009
+- fixed problem with caching of compiler plugins
+
+05/14/2009
+- fixed directory separator handling
+
+05/09/2009
+- syntax change for stream variables
+- fixed bug when using absolute template filepath and caching
+
+05/08/2009
+- fixed bug of {nocache} tag in included templates
+
+05/06/2009
+- allow that plugins_dir folder names can end without directory separator
+
+05/05/2009
+- fixed E_STRICT incompabilities
+- {function} tag bug fix
+- security policy definitions have been moved from plugins folder to file Security.class.php in libs folder
+- added allow_super_global configuration to security
+
+04/30/2009
+- functions defined with the {function} tag now always have global scope
+
+04/29/2009
+- fixed problem with directory setter methods
+- allow that cache_dir can end without directory separator
+
+04/28/2009
+- the {function} tag can no longer overwrite standard smarty tags
+- inherit functions defined by the {fuction} tag into subtemplates
+- added {while } sytax to while tag
+
+04/26/2009
+- added trusted stream checking to security
+- internal changes at file dependency check for caching
+
+04/24/2009
+- changed name of {template} tag to {function}
+- added new {template} tag
+
+04/23/2009
+- fixed access of special smarty variables from included template
+
+04/22/2009
+- unified template stream syntax with standard Smarty resource syntax $smarty->display('mystream:mytemplate')
+
+04/21/2009
+- change of new style syntax for forach. Now: {foreach $array as $var} like in PHP
+
+04/20/2009
+- fixed "$foo.bar ..." variable replacement in double quoted strings
+- fixed error in {include} tag with variable file attribute
+
+04/18/2009
+- added stream resources ($smarty->display('mystream://mytemplate'))
+- added stream variables {$mystream:myvar}
+
+04/14/2009
+- fixed compile_id handling on {include} tags
+- fixed append/prepend attributes in {block} tag
+- added {if 'expression' is in 'array'} syntax
+- use crc32 as hash for compiled config files.
+
+04/13/2009
+- fixed scope problem with parent variables when appending variables within templates.
+- fixed code for {block} without childs (possible sources for notice errors removed)
+
+04/12/2009
+- added append and prepend attribute to {block} tag
+
+04/11/2009
+- fixed variables in 'file' attribute of {extend} tag
+- fixed problems in modifiers (if mb string functions not present)
+
+04/10/2009
+- check if mb string functions available otherwise fallback to normal string functions
+- added global variable scope SMARTY_GLOBAL_SCOPE
+- enable 'variable' filter by default
+- fixed {$smarty.block.parent.foo}
+- implementation of a 'variable' filter as replacement for default modifier
+
+04/09/2009
+- fixed execution of filters defined by classes
+- compile the always the content of {block} tags to make shure that the filters are running over it
+- syntax corrections on variable object property
+- syntax corrections on array access in dot syntax
+
+04/08/2009
+- allow variable object property
+
+04/07/2009
+- changed variable scopes to SMARTY_LOCAL_SCOPE, SMARTY_PARENT_SCOPE, SMARTY_ROOT_SCOPE to avoid possible conflicts with user constants
+- Smarty variable global attribute replaced with scope attribute
+
+04/06/2009
+- variable scopes LOCAL_SCOPE, PARENT_SCOPE, ROOT_SCOPE
+- more getter/setter methods
+
+04/05/2009
+- replaced new array looping syntax {for $foo in $array} with {foreach $foo in $array} to avoid confusion
+- added append array for short form of assign {$foo[]='bar'} and allow assignments to nested arrays {$foo['bla']['blue']='bar'}
+
+04/04/2009
+- make output of template default handlers cachable and save compiled source
+- some fixes on yesterdays update
+
+04/03/2006
+- added registerDefaultTemplateHandler method and functionallity
+- added registerDefaultPluginHandler method and functionallity
+- added {append} tag to extend Smarty array variabled
+
+04/02/2009
+- added setter/getter methods
+- added $foo@first and $foo@last properties at {for} tag
+- added $set_timezone (true/false) property to setup optionally the default time zone
+
+03/31/2009
+- bugfix smarty.class and internal.security_handler
+- added compile_check configuration
+- added setter/getter methods
+
+03/30/2009
+- added all major setter/getter methods
+
+03/28/2009
+- {block} tags can be nested now
+- md5 hash function replace with crc32 for speed optimization
+- file order for exted resource inverted
+- clear_compiled_tpl and clear_cache_all will not touch .svn folder any longer
+
+03/27/2009
+- added extend resource
+
+03/26/2009
+- fixed parser not to create error on `word` in double quoted strings
+- allow PHP array(...)
+- implemented $smarty.block.name.parent to access parent block content
+- fixed smarty.class
+
+
+03/23/2009
+- fixed {foreachelse} and {forelse} tags
+
+03/22/2009
+- fixed possible sources for notice errors
+- rearrange SVN into distribution and development folders
+
+03/21/2009
+- fixed exceptions in function plugins
+- fixed notice error in Smarty.class.php
+- allow chained objects to span multiple lines
+- fixed error in modifers
+
+03/20/2009
+- moved /plugins folder into /libs folder
+- added noprint modifier
+- autoappend a directory separator if the xxxxx_dir definition have no trailing one
+
+03/19/2009
+- allow array definition as modifer parameter
+- changed modifier to use multi byte string funktions.
+
+03/17/2009
+- bugfix
+
+03/15/2009
+- added {include_php} tag for BC
+- removed @ error suppression
+- bugfix fetch did always repeat output of first call when calling same template several times
+- PHPunit tests extended
+
+03/13/2009
+- changed block syntax to be Smarty like {block:titel} -> {block name=titel}
+- compiling of {block} and {extend} tags rewriten for better performance
+- added special Smarty variable block ($smarty.block.foo} returns the parent definition of block foo
+- optimization of {block} tag compiled code.
+- fixed problem with escaped double quotes in double quoted strings
+
+03/12/2009
+- added support of template inheritance by {extend } and {block } tags.
+- bugfix comments within literals
+- added scope attribuie to {include} tag
+
+03/10/2009
+- couple of bugfixes and improvements
+- PHPunit tests extended
+
+03/09/2009
+- added support for global template vars. {assign_global...} $smarty->assign_global(...)
+- added direct_access_security
+- PHPunit tests extended
+- added missing {if} tag conditions like "is div by" etc.
+
+03/08/2009
+- splitted up the Compiler class to make it easier to use a coustom compiler
+- made default plugins_dir relative to Smarty root and not current working directory
+- some changes to make the lexer parser better configurable
+- implemented {section} tag for Smarty2 BC
+
+03/07/2009
+- fixed problem with comment tags
+- fixed problem with #xxxx in double quoted string
+- new {while} tag implemented
+- made lexer and paser class configurable as $smarty property
+- Smarty method get_template_vars implemented
+- Smarty method get_registered_object implemented
+- Smarty method trigger_error implemented
+- PHPunit tests extended
+
+03/06/2009
+- final changes on config variable handling
+- parser change - unquoted strings will by be converted into single quoted strings
+- PHPunit tests extended
+- some code cleanup
+- fixed problem on catenate strings with expression
+- update of count_words modifier
+- bugfix on comment tags
+
+
+03/05/2009
+- bugfix on tag with caching enabled
+- changes on exception handling (by Monte)
+
+03/04/2009
+- added support for config variables
+- bugfix on tag
+
+03/02/2009
+- fixed unqouted strings within modifier parameter
+- bugfix parsing of mofifier parameter
+
+03/01/2009
+- modifier chaining works now as in Smarty2
+
+02/28/2009
+- changed handling of unqouted strings
+
+02/26/2009
+- bugfix
+- changed $smarty.capture.foo to be global for Smarty2 BC.
+
+02/24/2009
+- bugfix {php} {/php} tags for backward compatibility
+- bugfix for expressions on arrays
+- fixed usage of "null" value
+- added $smarty.foreach.foo.first and $smarty.foreach.foo.last
+
+02/06/2009
+- bugfix for request variables without index for example $smarty.get
+- experimental solution for variable functions in static class
+
+02/05/2009
+- update of popup plugin
+- added config variables to template parser (load config functions still missing)
+- parser bugfix for empty quoted strings
+
+02/03/2009
+- allow array of objects as static class variabales.
+- use htmlentities at source output at template errors.
+
+02/02/2009
+- changed search order on modifiers to look at plugins folder first
+- parser bug fix for modifier on array elements $foo.bar|modifier
+- parser bug fix on single quoted srings
+- internal: splitted up compiler plugin files
+
+02/01/2009
+- allow method chaining on static classes
+- special Smarty variables $smarty.... implemented
+- added {PHP} {/PHP} tags for backward compatibility
+
+01/31/2009
+- added {math} plugin for Smarty2 BC
+- added template_exists method
+- changed Smarty3 method enable_security() to enableSecurity() to follow camelCase standards
+
+01/30/2009
+- bugfix in single quoted strings
+- changed syntax for variable property access from $foo:property to $foo@property because of ambiguous syntax at modifiers
+
+01/29/2009
+- syntax for array definition changed from (1,2,3) to [1,2,3] to remove ambiguous syntax
+- allow {for $foo in [1,2,3]} syntax
+- bugfix in double quoted strings
+- allow tags in template even if short_tags are enabled
+
+01/28/2009
+- fixed '!==' if condition.
+
+01/28/2009
+- added support of {strip} {/strip} tag.
+
+01/27/2009
+- bug fix on backticks in double quoted strings at objects
+
+01/25/2009
+- Smarty2 modfiers added to SVN
+
+01/25/2009
+- bugfix allow arrays at object properties in Smarty syntax
+- the template object is now passed as additional parameter at plugin calls
+- clear_compiled_tpl method completed
+
+01/20/2009
+- access to class constants implemented ( class::CONSTANT )
+- access to static class variables implemented ( class::$variable )
+- call of static class methods implemented ( class::method() )
+
+01/16/2009
+- reallow leading _ in variable names {$_var}
+- allow array of objects {$array.index->method()} syntax
+- finished work on clear_cache and clear_cache_all methods
+
+01/11/2009
+- added support of {literal} tag
+- added support of {ldelim} and {rdelim} tags
+- make code compatible to run with E_STRICT error setting
+
+01/08/2009
+- moved clear_assign and clear_all_assign to internal.templatebase.php
+- added assign_by_ref, append and append_by_ref methods
+
+01/02/2009
+- added load_filter method
+- fished work on filter handling
+- optimization of plugin loading
+
+12/30/2008
+- added compiler support of registered object
+- added backtick support in doubled quoted strings for backward compatibility
+- some minor bug fixes and improvments
+
+12/23/2008
+- fixed problem of not working "not" operator in if-expressions
+- added handling of compiler function plugins
+- finished work on (un)register_compiler_function method
+- finished work on (un)register_modifier method
+- plugin handling from plugins folder changed for modifier plugins
+ deleted - internal.modifier.php
+- added modifier chaining to parser
+
+12/17/2008
+- finished (un)register_function method
+- finished (un)register_block method
+- added security checking for PHP functions in PHP templates
+- plugin handling from plugins folder rewritten
+ new - internal.plugin_handler.php
+ deleted - internal.block.php
+ deleted - internal.function.php
+- removed plugin checking from security handler
+
+12/16/2008
+
+- new start of this change_log file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/libs/Smarty.class.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/libs/Smarty.class.php
new file mode 100644
index 000000000..40532fc2a
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/libs/Smarty.class.php
@@ -0,0 +1,1528 @@
+
+ * @author Uwe Tews
+ * @author Rodney Rehm
+ * @package Smarty
+ * @version 3.1.13
+ */
+
+/**
+ * define shorthand directory separator constant
+ */
+if (!defined('DS')) {
+ define('DS', DIRECTORY_SEPARATOR);
+}
+
+/**
+ * set SMARTY_DIR to absolute path to Smarty library files.
+ * Sets SMARTY_DIR only if user application has not already defined it.
+ */
+if (!defined('SMARTY_DIR')) {
+ define('SMARTY_DIR', dirname(__FILE__) . DS);
+}
+
+/**
+ * set SMARTY_SYSPLUGINS_DIR to absolute path to Smarty internal plugins.
+ * Sets SMARTY_SYSPLUGINS_DIR only if user application has not already defined it.
+ */
+if (!defined('SMARTY_SYSPLUGINS_DIR')) {
+ define('SMARTY_SYSPLUGINS_DIR', SMARTY_DIR . 'sysplugins' . DS);
+}
+if (!defined('SMARTY_PLUGINS_DIR')) {
+ define('SMARTY_PLUGINS_DIR', SMARTY_DIR . 'plugins' . DS);
+}
+if (!defined('SMARTY_MBSTRING')) {
+ define('SMARTY_MBSTRING', function_exists('mb_split'));
+}
+if (!defined('SMARTY_RESOURCE_CHAR_SET')) {
+ // UTF-8 can only be done properly when mbstring is available!
+ /**
+ * @deprecated in favor of Smarty::$_CHARSET
+ */
+ define('SMARTY_RESOURCE_CHAR_SET', SMARTY_MBSTRING ? 'UTF-8' : 'ISO-8859-1');
+}
+if (!defined('SMARTY_RESOURCE_DATE_FORMAT')) {
+ /**
+ * @deprecated in favor of Smarty::$_DATE_FORMAT
+ */
+ define('SMARTY_RESOURCE_DATE_FORMAT', '%b %e, %Y');
+}
+
+/**
+ * register the class autoloader
+ */
+if (!defined('SMARTY_SPL_AUTOLOAD')) {
+ define('SMARTY_SPL_AUTOLOAD', 0);
+}
+
+if (SMARTY_SPL_AUTOLOAD && set_include_path(get_include_path() . PATH_SEPARATOR . SMARTY_SYSPLUGINS_DIR) !== false) {
+ $registeredAutoLoadFunctions = spl_autoload_functions();
+ if (!isset($registeredAutoLoadFunctions['spl_autoload'])) {
+ spl_autoload_register();
+ }
+} else {
+ spl_autoload_register('smartyAutoload');
+}
+
+/**
+ * Load always needed external class files
+ */
+include_once SMARTY_SYSPLUGINS_DIR.'smarty_internal_data.php';
+include_once SMARTY_SYSPLUGINS_DIR.'smarty_internal_templatebase.php';
+include_once SMARTY_SYSPLUGINS_DIR.'smarty_internal_template.php';
+include_once SMARTY_SYSPLUGINS_DIR.'smarty_resource.php';
+include_once SMARTY_SYSPLUGINS_DIR.'smarty_internal_resource_file.php';
+include_once SMARTY_SYSPLUGINS_DIR.'smarty_cacheresource.php';
+include_once SMARTY_SYSPLUGINS_DIR.'smarty_internal_cacheresource_file.php';
+
+/**
+ * This is the main Smarty class
+ * @package Smarty
+ */
+class Smarty extends Smarty_Internal_TemplateBase {
+
+ /**#@+
+ * constant definitions
+ */
+
+ /**
+ * smarty version
+ */
+ const SMARTY_VERSION = 'Smarty-3.1.13';
+
+ /**
+ * define variable scopes
+ */
+ const SCOPE_LOCAL = 0;
+ const SCOPE_PARENT = 1;
+ const SCOPE_ROOT = 2;
+ const SCOPE_GLOBAL = 3;
+ /**
+ * define caching modes
+ */
+ const CACHING_OFF = 0;
+ const CACHING_LIFETIME_CURRENT = 1;
+ const CACHING_LIFETIME_SAVED = 2;
+ /**
+ * define compile check modes
+ */
+ const COMPILECHECK_OFF = 0;
+ const COMPILECHECK_ON = 1;
+ const COMPILECHECK_CACHEMISS = 2;
+ /**
+ * modes for handling of "" tags in templates.
+ */
+ const PHP_PASSTHRU = 0; //-> print tags as plain text
+ const PHP_QUOTE = 1; //-> escape tags as entities
+ const PHP_REMOVE = 2; //-> escape tags as entities
+ const PHP_ALLOW = 3; //-> escape tags as entities
+ /**
+ * filter types
+ */
+ const FILTER_POST = 'post';
+ const FILTER_PRE = 'pre';
+ const FILTER_OUTPUT = 'output';
+ const FILTER_VARIABLE = 'variable';
+ /**
+ * plugin types
+ */
+ const PLUGIN_FUNCTION = 'function';
+ const PLUGIN_BLOCK = 'block';
+ const PLUGIN_COMPILER = 'compiler';
+ const PLUGIN_MODIFIER = 'modifier';
+ const PLUGIN_MODIFIERCOMPILER = 'modifiercompiler';
+
+ /**#@-*/
+
+ /**
+ * assigned global tpl vars
+ */
+ public static $global_tpl_vars = array();
+
+ /**
+ * error handler returned by set_error_hanlder() in Smarty::muteExpectedErrors()
+ */
+ public static $_previous_error_handler = null;
+ /**
+ * contains directories outside of SMARTY_DIR that are to be muted by muteExpectedErrors()
+ */
+ public static $_muted_directories = array();
+ /**
+ * Flag denoting if Multibyte String functions are available
+ */
+ public static $_MBSTRING = SMARTY_MBSTRING;
+ /**
+ * The character set to adhere to (e.g. "UTF-8")
+ */
+ public static $_CHARSET = SMARTY_RESOURCE_CHAR_SET;
+ /**
+ * The date format to be used internally
+ * (accepts date() and strftime())
+ */
+ public static $_DATE_FORMAT = SMARTY_RESOURCE_DATE_FORMAT;
+ /**
+ * Flag denoting if PCRE should run in UTF-8 mode
+ */
+ public static $_UTF8_MODIFIER = 'u';
+
+ /**
+ * Flag denoting if operating system is windows
+ */
+ public static $_IS_WINDOWS = false;
+
+ /**#@+
+ * variables
+ */
+
+ /**
+ * auto literal on delimiters with whitspace
+ * @var boolean
+ */
+ public $auto_literal = true;
+ /**
+ * display error on not assigned variables
+ * @var boolean
+ */
+ public $error_unassigned = false;
+ /**
+ * look up relative filepaths in include_path
+ * @var boolean
+ */
+ public $use_include_path = false;
+ /**
+ * template directory
+ * @var array
+ */
+ private $template_dir = array();
+ /**
+ * joined template directory string used in cache keys
+ * @var string
+ */
+ public $joined_template_dir = null;
+ /**
+ * joined config directory string used in cache keys
+ * @var string
+ */
+ public $joined_config_dir = null;
+ /**
+ * default template handler
+ * @var callable
+ */
+ public $default_template_handler_func = null;
+ /**
+ * default config handler
+ * @var callable
+ */
+ public $default_config_handler_func = null;
+ /**
+ * default plugin handler
+ * @var callable
+ */
+ public $default_plugin_handler_func = null;
+ /**
+ * compile directory
+ * @var string
+ */
+ private $compile_dir = null;
+ /**
+ * plugins directory
+ * @var array
+ */
+ private $plugins_dir = array();
+ /**
+ * cache directory
+ * @var string
+ */
+ private $cache_dir = null;
+ /**
+ * config directory
+ * @var array
+ */
+ private $config_dir = array();
+ /**
+ * force template compiling?
+ * @var boolean
+ */
+ public $force_compile = false;
+ /**
+ * check template for modifications?
+ * @var boolean
+ */
+ public $compile_check = true;
+ /**
+ * use sub dirs for compiled/cached files?
+ * @var boolean
+ */
+ public $use_sub_dirs = false;
+ /**
+ * allow ambiguous resources (that are made unique by the resource handler)
+ * @var boolean
+ */
+ public $allow_ambiguous_resources = false;
+ /**
+ * caching enabled
+ * @var boolean
+ */
+ public $caching = false;
+ /**
+ * merge compiled includes
+ * @var boolean
+ */
+ public $merge_compiled_includes = false;
+ /**
+ * cache lifetime in seconds
+ * @var integer
+ */
+ public $cache_lifetime = 3600;
+ /**
+ * force cache file creation
+ * @var boolean
+ */
+ public $force_cache = false;
+ /**
+ * Set this if you want different sets of cache files for the same
+ * templates.
+ *
+ * @var string
+ */
+ public $cache_id = null;
+ /**
+ * Set this if you want different sets of compiled files for the same
+ * templates.
+ *
+ * @var string
+ */
+ public $compile_id = null;
+ /**
+ * template left-delimiter
+ * @var string
+ */
+ public $left_delimiter = "{";
+ /**
+ * template right-delimiter
+ * @var string
+ */
+ public $right_delimiter = "}";
+ /**#@+
+ * security
+ */
+ /**
+ * class name
+ *
+ * This should be instance of Smarty_Security.
+ *
+ * @var string
+ * @see Smarty_Security
+ */
+ public $security_class = 'Smarty_Security';
+ /**
+ * implementation of security class
+ *
+ * @var Smarty_Security
+ */
+ public $security_policy = null;
+ /**
+ * controls handling of PHP-blocks
+ *
+ * @var integer
+ */
+ public $php_handling = self::PHP_PASSTHRU;
+ /**
+ * controls if the php template file resource is allowed
+ *
+ * @var bool
+ */
+ public $allow_php_templates = false;
+ /**
+ * Should compiled-templates be prevented from being called directly?
+ *
+ * {@internal
+ * Currently used by Smarty_Internal_Template only.
+ * }}
+ *
+ * @var boolean
+ */
+ public $direct_access_security = true;
+ /**#@-*/
+ /**
+ * debug mode
+ *
+ * Setting this to true enables the debug-console.
+ *
+ * @var boolean
+ */
+ public $debugging = false;
+ /**
+ * This determines if debugging is enable-able from the browser.
+ *
+ *
NONE => no debugging control allowed
+ *
URL => enable debugging when SMARTY_DEBUG is found in the URL.
+ *
+ * @var string
+ */
+ public $debugging_ctrl = 'NONE';
+ /**
+ * Name of debugging URL-param.
+ *
+ * Only used when $debugging_ctrl is set to 'URL'.
+ * The name of the URL-parameter that activates debugging.
+ *
+ * @var type
+ */
+ public $smarty_debug_id = 'SMARTY_DEBUG';
+ /**
+ * Path of debug template.
+ * @var string
+ */
+ public $debug_tpl = null;
+ /**
+ * When set, smarty uses this value as error_reporting-level.
+ * @var int
+ */
+ public $error_reporting = null;
+ /**
+ * Internal flag for getTags()
+ * @var boolean
+ */
+ public $get_used_tags = false;
+
+ /**#@+
+ * config var settings
+ */
+
+ /**
+ * Controls whether variables with the same name overwrite each other.
+ * @var boolean
+ */
+ public $config_overwrite = true;
+ /**
+ * Controls whether config values of on/true/yes and off/false/no get converted to boolean.
+ * @var boolean
+ */
+ public $config_booleanize = true;
+ /**
+ * Controls whether hidden config sections/vars are read from the file.
+ * @var boolean
+ */
+ public $config_read_hidden = false;
+
+ /**#@-*/
+
+ /**#@+
+ * resource locking
+ */
+
+ /**
+ * locking concurrent compiles
+ * @var boolean
+ */
+ public $compile_locking = true;
+ /**
+ * Controls whether cache resources should emply locking mechanism
+ * @var boolean
+ */
+ public $cache_locking = false;
+ /**
+ * seconds to wait for acquiring a lock before ignoring the write lock
+ * @var float
+ */
+ public $locking_timeout = 10;
+
+ /**#@-*/
+
+ /**
+ * global template functions
+ * @var array
+ */
+ public $template_functions = array();
+ /**
+ * resource type used if none given
+ *
+ * Must be an valid key of $registered_resources.
+ * @var string
+ */
+ public $default_resource_type = 'file';
+ /**
+ * caching type
+ *
+ * Must be an element of $cache_resource_types.
+ *
+ * @var string
+ */
+ public $caching_type = 'file';
+ /**
+ * internal config properties
+ * @var array
+ */
+ public $properties = array();
+ /**
+ * config type
+ * @var string
+ */
+ public $default_config_type = 'file';
+ /**
+ * cached template objects
+ * @var array
+ */
+ public $template_objects = array();
+ /**
+ * check If-Modified-Since headers
+ * @var boolean
+ */
+ public $cache_modified_check = false;
+ /**
+ * registered plugins
+ * @var array
+ */
+ public $registered_plugins = array();
+ /**
+ * plugin search order
+ * @var array
+ */
+ public $plugin_search_order = array('function', 'block', 'compiler', 'class');
+ /**
+ * registered objects
+ * @var array
+ */
+ public $registered_objects = array();
+ /**
+ * registered classes
+ * @var array
+ */
+ public $registered_classes = array();
+ /**
+ * registered filters
+ * @var array
+ */
+ public $registered_filters = array();
+ /**
+ * registered resources
+ * @var array
+ */
+ public $registered_resources = array();
+ /**
+ * resource handler cache
+ * @var array
+ */
+ public $_resource_handlers = array();
+ /**
+ * registered cache resources
+ * @var array
+ */
+ public $registered_cache_resources = array();
+ /**
+ * cache resource handler cache
+ * @var array
+ */
+ public $_cacheresource_handlers = array();
+ /**
+ * autoload filter
+ * @var array
+ */
+ public $autoload_filters = array();
+ /**
+ * default modifier
+ * @var array
+ */
+ public $default_modifiers = array();
+ /**
+ * autoescape variable output
+ * @var boolean
+ */
+ public $escape_html = false;
+ /**
+ * global internal smarty vars
+ * @var array
+ */
+ public static $_smarty_vars = array();
+ /**
+ * start time for execution time calculation
+ * @var int
+ */
+ public $start_time = 0;
+ /**
+ * default file permissions
+ * @var int
+ */
+ public $_file_perms = 0644;
+ /**
+ * default dir permissions
+ * @var int
+ */
+ public $_dir_perms = 0771;
+ /**
+ * block tag hierarchy
+ * @var array
+ */
+ public $_tag_stack = array();
+ /**
+ * self pointer to Smarty object
+ * @var Smarty
+ */
+ public $smarty;
+ /**
+ * required by the compiler for BC
+ * @var string
+ */
+ public $_current_file = null;
+ /**
+ * internal flag to enable parser debugging
+ * @var bool
+ */
+ public $_parserdebug = false;
+ /**
+ * Saved parameter of merged templates during compilation
+ *
+ * @var array
+ */
+ public $merged_templates_func = array();
+ /**#@-*/
+
+ /**
+ * Initialize new Smarty object
+ *
+ */
+ public function __construct()
+ {
+ // selfpointer needed by some other class methods
+ $this->smarty = $this;
+ if (is_callable('mb_internal_encoding')) {
+ mb_internal_encoding(Smarty::$_CHARSET);
+ }
+ $this->start_time = microtime(true);
+ // set default dirs
+ $this->setTemplateDir('.' . DS . 'templates' . DS)
+ ->setCompileDir('.' . DS . 'templates_c' . DS)
+ ->setPluginsDir(SMARTY_PLUGINS_DIR)
+ ->setCacheDir('.' . DS . 'cache' . DS)
+ ->setConfigDir('.' . DS . 'configs' . DS);
+
+ $this->debug_tpl = 'file:' . dirname(__FILE__) . '/debug.tpl';
+ if (isset($_SERVER['SCRIPT_NAME'])) {
+ $this->assignGlobal('SCRIPT_NAME', $_SERVER['SCRIPT_NAME']);
+ }
+ }
+
+
+ /**
+ * Class destructor
+ */
+ public function __destruct()
+ {
+ // intentionally left blank
+ }
+
+ /**
+ * <> set selfpointer on cloned object
+ */
+ public function __clone()
+ {
+ $this->smarty = $this;
+ }
+
+
+ /**
+ * <> Generic getter.
+ *
+ * Calls the appropriate getter function.
+ * Issues an E_USER_NOTICE if no valid getter is found.
+ *
+ * @param string $name property name
+ * @return mixed
+ */
+ public function __get($name)
+ {
+ $allowed = array(
+ 'template_dir' => 'getTemplateDir',
+ 'config_dir' => 'getConfigDir',
+ 'plugins_dir' => 'getPluginsDir',
+ 'compile_dir' => 'getCompileDir',
+ 'cache_dir' => 'getCacheDir',
+ );
+
+ if (isset($allowed[$name])) {
+ return $this->{$allowed[$name]}();
+ } else {
+ trigger_error('Undefined property: '. get_class($this) .'::$'. $name, E_USER_NOTICE);
+ }
+ }
+
+ /**
+ * <> Generic setter.
+ *
+ * Calls the appropriate setter function.
+ * Issues an E_USER_NOTICE if no valid setter is found.
+ *
+ * @param string $name property name
+ * @param mixed $value parameter passed to setter
+ */
+ public function __set($name, $value)
+ {
+ $allowed = array(
+ 'template_dir' => 'setTemplateDir',
+ 'config_dir' => 'setConfigDir',
+ 'plugins_dir' => 'setPluginsDir',
+ 'compile_dir' => 'setCompileDir',
+ 'cache_dir' => 'setCacheDir',
+ );
+
+ if (isset($allowed[$name])) {
+ $this->{$allowed[$name]}($value);
+ } else {
+ trigger_error('Undefined property: ' . get_class($this) . '::$' . $name, E_USER_NOTICE);
+ }
+ }
+
+ /**
+ * Check if a template resource exists
+ *
+ * @param string $resource_name template name
+ * @return boolean status
+ */
+ public function templateExists($resource_name)
+ {
+ // create template object
+ $save = $this->template_objects;
+ $tpl = new $this->template_class($resource_name, $this);
+ // check if it does exists
+ $result = $tpl->source->exists;
+ $this->template_objects = $save;
+ return $result;
+ }
+
+ /**
+ * Returns a single or all global variables
+ *
+ * @param object $smarty
+ * @param string $varname variable name or null
+ * @return string variable value or or array of variables
+ */
+ public function getGlobal($varname = null)
+ {
+ if (isset($varname)) {
+ if (isset(self::$global_tpl_vars[$varname])) {
+ return self::$global_tpl_vars[$varname]->value;
+ } else {
+ return '';
+ }
+ } else {
+ $_result = array();
+ foreach (self::$global_tpl_vars AS $key => $var) {
+ $_result[$key] = $var->value;
+ }
+ return $_result;
+ }
+ }
+
+ /**
+ * Empty cache folder
+ *
+ * @param integer $exp_time expiration time
+ * @param string $type resource type
+ * @return integer number of cache files deleted
+ */
+ function clearAllCache($exp_time = null, $type = null)
+ {
+ // load cache resource and call clearAll
+ $_cache_resource = Smarty_CacheResource::load($this, $type);
+ Smarty_CacheResource::invalidLoadedCache($this);
+ return $_cache_resource->clearAll($this, $exp_time);
+ }
+
+ /**
+ * Empty cache for a specific template
+ *
+ * @param string $template_name template name
+ * @param string $cache_id cache id
+ * @param string $compile_id compile id
+ * @param integer $exp_time expiration time
+ * @param string $type resource type
+ * @return integer number of cache files deleted
+ */
+ public function clearCache($template_name, $cache_id = null, $compile_id = null, $exp_time = null, $type = null)
+ {
+ // load cache resource and call clear
+ $_cache_resource = Smarty_CacheResource::load($this, $type);
+ Smarty_CacheResource::invalidLoadedCache($this);
+ return $_cache_resource->clear($this, $template_name, $cache_id, $compile_id, $exp_time);
+ }
+
+ /**
+ * Loads security class and enables security
+ *
+ * @param string|Smarty_Security $security_class if a string is used, it must be class-name
+ * @return Smarty current Smarty instance for chaining
+ * @throws SmartyException when an invalid class name is provided
+ */
+ public function enableSecurity($security_class = null)
+ {
+ if ($security_class instanceof Smarty_Security) {
+ $this->security_policy = $security_class;
+ return $this;
+ } elseif (is_object($security_class)) {
+ throw new SmartyException("Class '" . get_class($security_class) . "' must extend Smarty_Security.");
+ }
+ if ($security_class == null) {
+ $security_class = $this->security_class;
+ }
+ if (!class_exists($security_class)) {
+ throw new SmartyException("Security class '$security_class' is not defined");
+ } elseif ($security_class !== 'Smarty_Security' && !is_subclass_of($security_class, 'Smarty_Security')) {
+ throw new SmartyException("Class '$security_class' must extend Smarty_Security.");
+ } else {
+ $this->security_policy = new $security_class($this);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Disable security
+ * @return Smarty current Smarty instance for chaining
+ */
+ public function disableSecurity()
+ {
+ $this->security_policy = null;
+
+ return $this;
+ }
+
+ /**
+ * Set template directory
+ *
+ * @param string|array $template_dir directory(s) of template sources
+ * @return Smarty current Smarty instance for chaining
+ */
+ public function setTemplateDir($template_dir)
+ {
+ $this->template_dir = array();
+ foreach ((array) $template_dir as $k => $v) {
+ $this->template_dir[$k] = rtrim($v, '/\\') . DS;
+ }
+
+ $this->joined_template_dir = join(DIRECTORY_SEPARATOR, $this->template_dir);
+ return $this;
+ }
+
+ /**
+ * Add template directory(s)
+ *
+ * @param string|array $template_dir directory(s) of template sources
+ * @param string $key of the array element to assign the template dir to
+ * @return Smarty current Smarty instance for chaining
+ * @throws SmartyException when the given template directory is not valid
+ */
+ public function addTemplateDir($template_dir, $key=null)
+ {
+ // make sure we're dealing with an array
+ $this->template_dir = (array) $this->template_dir;
+
+ if (is_array($template_dir)) {
+ foreach ($template_dir as $k => $v) {
+ if (is_int($k)) {
+ // indexes are not merged but appended
+ $this->template_dir[] = rtrim($v, '/\\') . DS;
+ } else {
+ // string indexes are overridden
+ $this->template_dir[$k] = rtrim($v, '/\\') . DS;
+ }
+ }
+ } elseif ($key !== null) {
+ // override directory at specified index
+ $this->template_dir[$key] = rtrim($template_dir, '/\\') . DS;
+ } else {
+ // append new directory
+ $this->template_dir[] = rtrim($template_dir, '/\\') . DS;
+ }
+ $this->joined_template_dir = join(DIRECTORY_SEPARATOR, $this->template_dir);
+ return $this;
+ }
+
+ /**
+ * Get template directories
+ *
+ * @param mixed index of directory to get, null to get all
+ * @return array|string list of template directories, or directory of $index
+ */
+ public function getTemplateDir($index=null)
+ {
+ if ($index !== null) {
+ return isset($this->template_dir[$index]) ? $this->template_dir[$index] : null;
+ }
+
+ return (array)$this->template_dir;
+ }
+
+ /**
+ * Set config directory
+ *
+ * @param string|array $template_dir directory(s) of configuration sources
+ * @return Smarty current Smarty instance for chaining
+ */
+ public function setConfigDir($config_dir)
+ {
+ $this->config_dir = array();
+ foreach ((array) $config_dir as $k => $v) {
+ $this->config_dir[$k] = rtrim($v, '/\\') . DS;
+ }
+
+ $this->joined_config_dir = join(DIRECTORY_SEPARATOR, $this->config_dir);
+ return $this;
+ }
+
+ /**
+ * Add config directory(s)
+ *
+ * @param string|array $config_dir directory(s) of config sources
+ * @param string key of the array element to assign the config dir to
+ * @return Smarty current Smarty instance for chaining
+ */
+ public function addConfigDir($config_dir, $key=null)
+ {
+ // make sure we're dealing with an array
+ $this->config_dir = (array) $this->config_dir;
+
+ if (is_array($config_dir)) {
+ foreach ($config_dir as $k => $v) {
+ if (is_int($k)) {
+ // indexes are not merged but appended
+ $this->config_dir[] = rtrim($v, '/\\') . DS;
+ } else {
+ // string indexes are overridden
+ $this->config_dir[$k] = rtrim($v, '/\\') . DS;
+ }
+ }
+ } elseif( $key !== null ) {
+ // override directory at specified index
+ $this->config_dir[$key] = rtrim($config_dir, '/\\') . DS;
+ } else {
+ // append new directory
+ $this->config_dir[] = rtrim($config_dir, '/\\') . DS;
+ }
+
+ $this->joined_config_dir = join(DIRECTORY_SEPARATOR, $this->config_dir);
+ return $this;
+ }
+
+ /**
+ * Get config directory
+ *
+ * @param mixed index of directory to get, null to get all
+ * @return array|string configuration directory
+ */
+ public function getConfigDir($index=null)
+ {
+ if ($index !== null) {
+ return isset($this->config_dir[$index]) ? $this->config_dir[$index] : null;
+ }
+
+ return (array)$this->config_dir;
+ }
+
+ /**
+ * Set plugins directory
+ *
+ * @param string|array $plugins_dir directory(s) of plugins
+ * @return Smarty current Smarty instance for chaining
+ */
+ public function setPluginsDir($plugins_dir)
+ {
+ $this->plugins_dir = array();
+ foreach ((array)$plugins_dir as $k => $v) {
+ $this->plugins_dir[$k] = rtrim($v, '/\\') . DS;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Adds directory of plugin files
+ *
+ * @param object $smarty
+ * @param string $ |array $ plugins folder
+ * @return Smarty current Smarty instance for chaining
+ */
+ public function addPluginsDir($plugins_dir)
+ {
+ // make sure we're dealing with an array
+ $this->plugins_dir = (array) $this->plugins_dir;
+
+ if (is_array($plugins_dir)) {
+ foreach ($plugins_dir as $k => $v) {
+ if (is_int($k)) {
+ // indexes are not merged but appended
+ $this->plugins_dir[] = rtrim($v, '/\\') . DS;
+ } else {
+ // string indexes are overridden
+ $this->plugins_dir[$k] = rtrim($v, '/\\') . DS;
+ }
+ }
+ } else {
+ // append new directory
+ $this->plugins_dir[] = rtrim($plugins_dir, '/\\') . DS;
+ }
+
+ $this->plugins_dir = array_unique($this->plugins_dir);
+ return $this;
+ }
+
+ /**
+ * Get plugin directories
+ *
+ * @return array list of plugin directories
+ */
+ public function getPluginsDir()
+ {
+ return (array)$this->plugins_dir;
+ }
+
+ /**
+ * Set compile directory
+ *
+ * @param string $compile_dir directory to store compiled templates in
+ * @return Smarty current Smarty instance for chaining
+ */
+ public function setCompileDir($compile_dir)
+ {
+ $this->compile_dir = rtrim($compile_dir, '/\\') . DS;
+ if (!isset(Smarty::$_muted_directories[$this->compile_dir])) {
+ Smarty::$_muted_directories[$this->compile_dir] = null;
+ }
+ return $this;
+ }
+
+ /**
+ * Get compiled directory
+ *
+ * @return string path to compiled templates
+ */
+ public function getCompileDir()
+ {
+ return $this->compile_dir;
+ }
+
+ /**
+ * Set cache directory
+ *
+ * @param string $cache_dir directory to store cached templates in
+ * @return Smarty current Smarty instance for chaining
+ */
+ public function setCacheDir($cache_dir)
+ {
+ $this->cache_dir = rtrim($cache_dir, '/\\') . DS;
+ if (!isset(Smarty::$_muted_directories[$this->cache_dir])) {
+ Smarty::$_muted_directories[$this->cache_dir] = null;
+ }
+ return $this;
+ }
+
+ /**
+ * Get cache directory
+ *
+ * @return string path of cache directory
+ */
+ public function getCacheDir()
+ {
+ return $this->cache_dir;
+ }
+
+ /**
+ * Set default modifiers
+ *
+ * @param array|string $modifiers modifier or list of modifiers to set
+ * @return Smarty current Smarty instance for chaining
+ */
+ public function setDefaultModifiers($modifiers)
+ {
+ $this->default_modifiers = (array) $modifiers;
+ return $this;
+ }
+
+ /**
+ * Add default modifiers
+ *
+ * @param array|string $modifiers modifier or list of modifiers to add
+ * @return Smarty current Smarty instance for chaining
+ */
+ public function addDefaultModifiers($modifiers)
+ {
+ if (is_array($modifiers)) {
+ $this->default_modifiers = array_merge($this->default_modifiers, $modifiers);
+ } else {
+ $this->default_modifiers[] = $modifiers;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get default modifiers
+ *
+ * @return array list of default modifiers
+ */
+ public function getDefaultModifiers()
+ {
+ return $this->default_modifiers;
+ }
+
+
+ /**
+ * Set autoload filters
+ *
+ * @param array $filters filters to load automatically
+ * @param string $type "pre", "output", … specify the filter type to set. Defaults to none treating $filters' keys as the appropriate types
+ * @return Smarty current Smarty instance for chaining
+ */
+ public function setAutoloadFilters($filters, $type=null)
+ {
+ if ($type !== null) {
+ $this->autoload_filters[$type] = (array) $filters;
+ } else {
+ $this->autoload_filters = (array) $filters;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Add autoload filters
+ *
+ * @param array $filters filters to load automatically
+ * @param string $type "pre", "output", … specify the filter type to set. Defaults to none treating $filters' keys as the appropriate types
+ * @return Smarty current Smarty instance for chaining
+ */
+ public function addAutoloadFilters($filters, $type=null)
+ {
+ if ($type !== null) {
+ if (!empty($this->autoload_filters[$type])) {
+ $this->autoload_filters[$type] = array_merge($this->autoload_filters[$type], (array) $filters);
+ } else {
+ $this->autoload_filters[$type] = (array) $filters;
+ }
+ } else {
+ foreach ((array) $filters as $key => $value) {
+ if (!empty($this->autoload_filters[$key])) {
+ $this->autoload_filters[$key] = array_merge($this->autoload_filters[$key], (array) $value);
+ } else {
+ $this->autoload_filters[$key] = (array) $value;
+ }
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get autoload filters
+ *
+ * @param string $type type of filter to get autoloads for. Defaults to all autoload filters
+ * @return array array( 'type1' => array( 'filter1', 'filter2', … ) ) or array( 'filter1', 'filter2', …) if $type was specified
+ */
+ public function getAutoloadFilters($type=null)
+ {
+ if ($type !== null) {
+ return isset($this->autoload_filters[$type]) ? $this->autoload_filters[$type] : array();
+ }
+
+ return $this->autoload_filters;
+ }
+
+ /**
+ * return name of debugging template
+ *
+ * @return string
+ */
+ public function getDebugTemplate()
+ {
+ return $this->debug_tpl;
+ }
+
+ /**
+ * set the debug template
+ *
+ * @param string $tpl_name
+ * @return Smarty current Smarty instance for chaining
+ * @throws SmartyException if file is not readable
+ */
+ public function setDebugTemplate($tpl_name)
+ {
+ if (!is_readable($tpl_name)) {
+ throw new SmartyException("Unknown file '{$tpl_name}'");
+ }
+ $this->debug_tpl = $tpl_name;
+
+ return $this;
+ }
+
+ /**
+ * creates a template object
+ *
+ * @param string $template the resource handle of the template file
+ * @param mixed $cache_id cache id to be used with this template
+ * @param mixed $compile_id compile id to be used with this template
+ * @param object $parent next higher level of Smarty variables
+ * @param boolean $do_clone flag is Smarty object shall be cloned
+ * @return object template object
+ */
+ public function createTemplate($template, $cache_id = null, $compile_id = null, $parent = null, $do_clone = true)
+ {
+ if (!empty($cache_id) && (is_object($cache_id) || is_array($cache_id))) {
+ $parent = $cache_id;
+ $cache_id = null;
+ }
+ if (!empty($parent) && is_array($parent)) {
+ $data = $parent;
+ $parent = null;
+ } else {
+ $data = null;
+ }
+ // default to cache_id and compile_id of Smarty object
+ $cache_id = $cache_id === null ? $this->cache_id : $cache_id;
+ $compile_id = $compile_id === null ? $this->compile_id : $compile_id;
+ // already in template cache?
+ if ($this->allow_ambiguous_resources) {
+ $_templateId = Smarty_Resource::getUniqueTemplateName($this, $template) . $cache_id . $compile_id;
+ } else {
+ $_templateId = $this->joined_template_dir . '#' . $template . $cache_id . $compile_id;
+ }
+ if (isset($_templateId[150])) {
+ $_templateId = sha1($_templateId);
+ }
+ if ($do_clone) {
+ if (isset($this->template_objects[$_templateId])) {
+ // return cached template object
+ $tpl = clone $this->template_objects[$_templateId];
+ $tpl->smarty = clone $tpl->smarty;
+ $tpl->parent = $parent;
+ $tpl->tpl_vars = array();
+ $tpl->config_vars = array();
+ } else {
+ $tpl = new $this->template_class($template, clone $this, $parent, $cache_id, $compile_id);
+ }
+ } else {
+ if (isset($this->template_objects[$_templateId])) {
+ // return cached template object
+ $tpl = $this->template_objects[$_templateId];
+ $tpl->parent = $parent;
+ $tpl->tpl_vars = array();
+ $tpl->config_vars = array();
+ } else {
+ $tpl = new $this->template_class($template, $this, $parent, $cache_id, $compile_id);
+ }
+ }
+ // fill data if present
+ if (!empty($data) && is_array($data)) {
+ // set up variable values
+ foreach ($data as $_key => $_val) {
+ $tpl->tpl_vars[$_key] = new Smarty_variable($_val);
+ }
+ }
+ return $tpl;
+ }
+
+
+ /**
+ * Takes unknown classes and loads plugin files for them
+ * class name format: Smarty_PluginType_PluginName
+ * plugin filename format: plugintype.pluginname.php
+ *
+ * @param string $plugin_name class plugin name to load
+ * @param bool $check check if already loaded
+ * @return string |boolean filepath of loaded file or false
+ */
+ public function loadPlugin($plugin_name, $check = true)
+ {
+ // if function or class exists, exit silently (already loaded)
+ if ($check && (is_callable($plugin_name) || class_exists($plugin_name, false))) {
+ return true;
+ }
+ // Plugin name is expected to be: Smarty_[Type]_[Name]
+ $_name_parts = explode('_', $plugin_name, 3);
+ // class name must have three parts to be valid plugin
+ // count($_name_parts) < 3 === !isset($_name_parts[2])
+ if (!isset($_name_parts[2]) || strtolower($_name_parts[0]) !== 'smarty') {
+ throw new SmartyException("plugin {$plugin_name} is not a valid name format");
+ return false;
+ }
+ // if type is "internal", get plugin from sysplugins
+ if (strtolower($_name_parts[1]) == 'internal') {
+ $file = SMARTY_SYSPLUGINS_DIR . strtolower($plugin_name) . '.php';
+ if (file_exists($file)) {
+ require_once($file);
+ return $file;
+ } else {
+ return false;
+ }
+ }
+ // plugin filename is expected to be: [type].[name].php
+ $_plugin_filename = "{$_name_parts[1]}.{$_name_parts[2]}.php";
+
+ $_stream_resolve_include_path = function_exists('stream_resolve_include_path');
+
+ // loop through plugin dirs and find the plugin
+ foreach($this->getPluginsDir() as $_plugin_dir) {
+ $names = array(
+ $_plugin_dir . $_plugin_filename,
+ $_plugin_dir . strtolower($_plugin_filename),
+ );
+ foreach ($names as $file) {
+ if (file_exists($file)) {
+ require_once($file);
+ return $file;
+ }
+ if ($this->use_include_path && !preg_match('/^([\/\\\\]|[a-zA-Z]:[\/\\\\])/', $_plugin_dir)) {
+ // try PHP include_path
+ if ($_stream_resolve_include_path) {
+ $file = stream_resolve_include_path($file);
+ } else {
+ $file = Smarty_Internal_Get_Include_Path::getIncludePath($file);
+ }
+
+ if ($file !== false) {
+ require_once($file);
+ return $file;
+ }
+ }
+ }
+ }
+ // no plugin loaded
+ return false;
+ }
+
+ /**
+ * Compile all template files
+ *
+ * @param string $extension file extension
+ * @param bool $force_compile force all to recompile
+ * @param int $time_limit
+ * @param int $max_errors
+ * @return integer number of template files recompiled
+ */
+ public function compileAllTemplates($extention = '.tpl', $force_compile = false, $time_limit = 0, $max_errors = null)
+ {
+ return Smarty_Internal_Utility::compileAllTemplates($extention, $force_compile, $time_limit, $max_errors, $this);
+ }
+
+ /**
+ * Compile all config files
+ *
+ * @param string $extension file extension
+ * @param bool $force_compile force all to recompile
+ * @param int $time_limit
+ * @param int $max_errors
+ * @return integer number of template files recompiled
+ */
+ public function compileAllConfig($extention = '.conf', $force_compile = false, $time_limit = 0, $max_errors = null)
+ {
+ return Smarty_Internal_Utility::compileAllConfig($extention, $force_compile, $time_limit, $max_errors, $this);
+ }
+
+ /**
+ * Delete compiled template file
+ *
+ * @param string $resource_name template name
+ * @param string $compile_id compile id
+ * @param integer $exp_time expiration time
+ * @return integer number of template files deleted
+ */
+ public function clearCompiledTemplate($resource_name = null, $compile_id = null, $exp_time = null)
+ {
+ return Smarty_Internal_Utility::clearCompiledTemplate($resource_name, $compile_id, $exp_time, $this);
+ }
+
+
+ /**
+ * Return array of tag/attributes of all tags used by an template
+ *
+ * @param object $templae template object
+ * @return array of tag/attributes
+ */
+ public function getTags(Smarty_Internal_Template $template)
+ {
+ return Smarty_Internal_Utility::getTags($template);
+ }
+
+ /**
+ * Run installation test
+ *
+ * @param array $errors Array to write errors into, rather than outputting them
+ * @return boolean true if setup is fine, false if something is wrong
+ */
+ public function testInstall(&$errors=null)
+ {
+ return Smarty_Internal_Utility::testInstall($this, $errors);
+ }
+
+ /**
+ * Error Handler to mute expected messages
+ *
+ * @link http://php.net/set_error_handler
+ * @param integer $errno Error level
+ * @return boolean
+ */
+ public static function mutingErrorHandler($errno, $errstr, $errfile, $errline, $errcontext)
+ {
+ $_is_muted_directory = false;
+
+ // add the SMARTY_DIR to the list of muted directories
+ if (!isset(Smarty::$_muted_directories[SMARTY_DIR])) {
+ $smarty_dir = realpath(SMARTY_DIR);
+ if ($smarty_dir !== false) {
+ Smarty::$_muted_directories[SMARTY_DIR] = array(
+ 'file' => $smarty_dir,
+ 'length' => strlen($smarty_dir),
+ );
+ }
+ }
+
+ // walk the muted directories and test against $errfile
+ foreach (Smarty::$_muted_directories as $key => &$dir) {
+ if (!$dir) {
+ // resolve directory and length for speedy comparisons
+ $file = realpath($key);
+ if ($file === false) {
+ // this directory does not exist, remove and skip it
+ unset(Smarty::$_muted_directories[$key]);
+ continue;
+ }
+ $dir = array(
+ 'file' => $file,
+ 'length' => strlen($file),
+ );
+ }
+ if (!strncmp($errfile, $dir['file'], $dir['length'])) {
+ $_is_muted_directory = true;
+ break;
+ }
+ }
+
+ // pass to next error handler if this error did not occur inside SMARTY_DIR
+ // or the error was within smarty but masked to be ignored
+ if (!$_is_muted_directory || ($errno && $errno & error_reporting())) {
+ if (Smarty::$_previous_error_handler) {
+ return call_user_func(Smarty::$_previous_error_handler, $errno, $errstr, $errfile, $errline, $errcontext);
+ } else {
+ return false;
+ }
+ }
+ }
+
+ /**
+ * Enable error handler to mute expected messages
+ *
+ * @return void
+ */
+ public static function muteExpectedErrors()
+ {
+ /*
+ error muting is done because some people implemented custom error_handlers using
+ http://php.net/set_error_handler and for some reason did not understand the following paragraph:
+
+ It is important to remember that the standard PHP error handler is completely bypassed for the
+ error types specified by error_types unless the callback function returns FALSE.
+ error_reporting() settings will have no effect and your error handler will be called regardless -
+ however you are still able to read the current value of error_reporting and act appropriately.
+ Of particular note is that this value will be 0 if the statement that caused the error was
+ prepended by the @ error-control operator.
+
+ Smarty deliberately uses @filemtime() over file_exists() and filemtime() in some places. Reasons include
+ - @filemtime() is almost twice as fast as using an additional file_exists()
+ - between file_exists() and filemtime() a possible race condition is opened,
+ which does not exist using the simple @filemtime() approach.
+ */
+ $error_handler = array('Smarty', 'mutingErrorHandler');
+ $previous = set_error_handler($error_handler);
+
+ // avoid dead loops
+ if ($previous !== $error_handler) {
+ Smarty::$_previous_error_handler = $previous;
+ }
+ }
+
+ /**
+ * Disable error handler muting expected messages
+ *
+ * @return void
+ */
+ public static function unmuteExpectedErrors()
+ {
+ restore_error_handler();
+ }
+}
+
+// Check if we're running on windows
+Smarty::$_IS_WINDOWS = strtoupper(substr(PHP_OS, 0, 3)) === 'WIN';
+
+// let PCRE (preg_*) treat strings as ISO-8859-1 if we're not dealing with UTF-8
+if (Smarty::$_CHARSET !== 'UTF-8') {
+ Smarty::$_UTF8_MODIFIER = '';
+}
+
+/**
+ * Smarty exception class
+ * @package Smarty
+ */
+class SmartyException extends Exception {
+ public static $escape = true;
+ public function __construct($message) {
+ $this->message = self::$escape ? htmlentities($message) : $message;
+ }
+}
+
+/**
+ * Smarty compiler exception class
+ * @package Smarty
+ */
+class SmartyCompilerException extends SmartyException {
+}
+
+/**
+ * Autoloader
+ */
+function smartyAutoload($class)
+{
+ $_class = strtolower($class);
+ $_classes = array(
+ 'smarty_config_source' => true,
+ 'smarty_config_compiled' => true,
+ 'smarty_security' => true,
+ 'smarty_cacheresource' => true,
+ 'smarty_cacheresource_custom' => true,
+ 'smarty_cacheresource_keyvaluestore' => true,
+ 'smarty_resource' => true,
+ 'smarty_resource_custom' => true,
+ 'smarty_resource_uncompiled' => true,
+ 'smarty_resource_recompiled' => true,
+ );
+
+ if (!strncmp($_class, 'smarty_internal_', 16) || isset($_classes[$_class])) {
+ include SMARTY_SYSPLUGINS_DIR . $_class . '.php';
+ }
+}
+
+?>
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/libs/SmartyBC.class.php b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/libs/SmartyBC.class.php
new file mode 100644
index 000000000..f8f0a138f
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/libs/SmartyBC.class.php
@@ -0,0 +1,460 @@
+
+ * @author Uwe Tews
+ * @author Rodney Rehm
+ * @package Smarty
+ */
+/**
+ * @ignore
+ */
+require(dirname(__FILE__) . '/Smarty.class.php');
+
+/**
+ * Smarty Backward Compatability Wrapper Class
+ *
+ * @package Smarty
+ */
+class SmartyBC extends Smarty {
+
+ /**
+ * Smarty 2 BC
+ * @var string
+ */
+ public $_version = self::SMARTY_VERSION;
+
+ /**
+ * Initialize new SmartyBC object
+ *
+ * @param array $options options to set during initialization, e.g. array( 'forceCompile' => false )
+ */
+ public function __construct(array $options=array())
+ {
+ parent::__construct($options);
+ // register {php} tag
+ $this->registerPlugin('block', 'php', 'smarty_php_tag');
+ }
+
+ /**
+ * wrapper for assign_by_ref
+ *
+ * @param string $tpl_var the template variable name
+ * @param mixed &$value the referenced value to assign
+ */
+ public function assign_by_ref($tpl_var, &$value)
+ {
+ $this->assignByRef($tpl_var, $value);
+ }
+
+ /**
+ * wrapper for append_by_ref
+ *
+ * @param string $tpl_var the template variable name
+ * @param mixed &$value the referenced value to append
+ * @param boolean $merge flag if array elements shall be merged
+ */
+ public function append_by_ref($tpl_var, &$value, $merge = false)
+ {
+ $this->appendByRef($tpl_var, $value, $merge);
+ }
+
+ /**
+ * clear the given assigned template variable.
+ *
+ * @param string $tpl_var the template variable to clear
+ */
+ public function clear_assign($tpl_var)
+ {
+ $this->clearAssign($tpl_var);
+ }
+
+ /**
+ * Registers custom function to be used in templates
+ *
+ * @param string $function the name of the template function
+ * @param string $function_impl the name of the PHP function to register
+ * @param bool $cacheable
+ * @param mixed $cache_attrs
+ */
+ public function register_function($function, $function_impl, $cacheable=true, $cache_attrs=null)
+ {
+ $this->registerPlugin('function', $function, $function_impl, $cacheable, $cache_attrs);
+ }
+
+ /**
+ * Unregisters custom function
+ *
+ * @param string $function name of template function
+ */
+ public function unregister_function($function)
+ {
+ $this->unregisterPlugin('function', $function);
+ }
+
+ /**
+ * Registers object to be used in templates
+ *
+ * @param string $object name of template object
+ * @param object $object_impl the referenced PHP object to register
+ * @param array $allowed list of allowed methods (empty = all)
+ * @param boolean $smarty_args smarty argument format, else traditional
+ * @param array $block_functs list of methods that are block format
+ */
+ public function register_object($object, $object_impl, $allowed = array(), $smarty_args = true, $block_methods = array())
+ {
+ settype($allowed, 'array');
+ settype($smarty_args, 'boolean');
+ $this->registerObject($object, $object_impl, $allowed, $smarty_args, $block_methods);
+ }
+
+ /**
+ * Unregisters object
+ *
+ * @param string $object name of template object
+ */
+ public function unregister_object($object)
+ {
+ $this->unregisterObject($object);
+ }
+
+ /**
+ * Registers block function to be used in templates
+ *
+ * @param string $block name of template block
+ * @param string $block_impl PHP function to register
+ * @param bool $cacheable
+ * @param mixed $cache_attrs
+ */
+ public function register_block($block, $block_impl, $cacheable=true, $cache_attrs=null)
+ {
+ $this->registerPlugin('block', $block, $block_impl, $cacheable, $cache_attrs);
+ }
+
+ /**
+ * Unregisters block function
+ *
+ * @param string $block name of template function
+ */
+ public function unregister_block($block)
+ {
+ $this->unregisterPlugin('block', $block);
+ }
+
+ /**
+ * Registers compiler function
+ *
+ * @param string $function name of template function
+ * @param string $function_impl name of PHP function to register
+ * @param bool $cacheable
+ */
+ public function register_compiler_function($function, $function_impl, $cacheable=true)
+ {
+ $this->registerPlugin('compiler', $function, $function_impl, $cacheable);
+ }
+
+ /**
+ * Unregisters compiler function
+ *
+ * @param string $function name of template function
+ */
+ public function unregister_compiler_function($function)
+ {
+ $this->unregisterPlugin('compiler', $function);
+ }
+
+ /**
+ * Registers modifier to be used in templates
+ *
+ * @param string $modifier name of template modifier
+ * @param string $modifier_impl name of PHP function to register
+ */
+ public function register_modifier($modifier, $modifier_impl)
+ {
+ $this->registerPlugin('modifier', $modifier, $modifier_impl);
+ }
+
+ /**
+ * Unregisters modifier
+ *
+ * @param string $modifier name of template modifier
+ */
+ public function unregister_modifier($modifier)
+ {
+ $this->unregisterPlugin('modifier', $modifier);
+ }
+
+ /**
+ * Registers a resource to fetch a template
+ *
+ * @param string $type name of resource
+ * @param array $functions array of functions to handle resource
+ */
+ public function register_resource($type, $functions)
+ {
+ $this->registerResource($type, $functions);
+ }
+
+ /**
+ * Unregisters a resource
+ *
+ * @param string $type name of resource
+ */
+ public function unregister_resource($type)
+ {
+ $this->unregisterResource($type);
+ }
+
+ /**
+ * Registers a prefilter function to apply
+ * to a template before compiling
+ *
+ * @param callable $function
+ */
+ public function register_prefilter($function)
+ {
+ $this->registerFilter('pre', $function);
+ }
+
+ /**
+ * Unregisters a prefilter function
+ *
+ * @param callable $function
+ */
+ public function unregister_prefilter($function)
+ {
+ $this->unregisterFilter('pre', $function);
+ }
+
+ /**
+ * Registers a postfilter function to apply
+ * to a compiled template after compilation
+ *
+ * @param callable $function
+ */
+ public function register_postfilter($function)
+ {
+ $this->registerFilter('post', $function);
+ }
+
+ /**
+ * Unregisters a postfilter function
+ *
+ * @param callable $function
+ */
+ public function unregister_postfilter($function)
+ {
+ $this->unregisterFilter('post', $function);
+ }
+
+ /**
+ * Registers an output filter function to apply
+ * to a template output
+ *
+ * @param callable $function
+ */
+ public function register_outputfilter($function)
+ {
+ $this->registerFilter('output', $function);
+ }
+
+ /**
+ * Unregisters an outputfilter function
+ *
+ * @param callable $function
+ */
+ public function unregister_outputfilter($function)
+ {
+ $this->unregisterFilter('output', $function);
+ }
+
+ /**
+ * load a filter of specified type and name
+ *
+ * @param string $type filter type
+ * @param string $name filter name
+ */
+ public function load_filter($type, $name)
+ {
+ $this->loadFilter($type, $name);
+ }
+
+ /**
+ * clear cached content for the given template and cache id
+ *
+ * @param string $tpl_file name of template file
+ * @param string $cache_id name of cache_id
+ * @param string $compile_id name of compile_id
+ * @param string $exp_time expiration time
+ * @return boolean
+ */
+ public function clear_cache($tpl_file = null, $cache_id = null, $compile_id = null, $exp_time = null)
+ {
+ return $this->clearCache($tpl_file, $cache_id, $compile_id, $exp_time);
+ }
+
+ /**
+ * clear the entire contents of cache (all templates)
+ *
+ * @param string $exp_time expire time
+ * @return boolean
+ */
+ public function clear_all_cache($exp_time = null)
+ {
+ return $this->clearCache(null, null, null, $exp_time);
+ }
+
+ /**
+ * test to see if valid cache exists for this template
+ *
+ * @param string $tpl_file name of template file
+ * @param string $cache_id
+ * @param string $compile_id
+ * @return boolean
+ */
+ public function is_cached($tpl_file, $cache_id = null, $compile_id = null)
+ {
+ return $this->isCached($tpl_file, $cache_id, $compile_id);
+ }
+
+ /**
+ * clear all the assigned template variables.
+ */
+ public function clear_all_assign()
+ {
+ $this->clearAllAssign();
+ }
+
+ /**
+ * clears compiled version of specified template resource,
+ * or all compiled template files if one is not specified.
+ * This function is for advanced use only, not normally needed.
+ *
+ * @param string $tpl_file
+ * @param string $compile_id
+ * @param string $exp_time
+ * @return boolean results of {@link smarty_core_rm_auto()}
+ */
+ public function clear_compiled_tpl($tpl_file = null, $compile_id = null, $exp_time = null)
+ {
+ return $this->clearCompiledTemplate($tpl_file, $compile_id, $exp_time);
+ }
+
+ /**
+ * Checks whether requested template exists.
+ *
+ * @param string $tpl_file
+ * @return boolean
+ */
+ public function template_exists($tpl_file)
+ {
+ return $this->templateExists($tpl_file);
+ }
+
+ /**
+ * Returns an array containing template variables
+ *
+ * @param string $name
+ * @return array
+ */
+ public function get_template_vars($name=null)
+ {
+ return $this->getTemplateVars($name);
+ }
+
+ /**
+ * Returns an array containing config variables
+ *
+ * @param string $name
+ * @return array
+ */
+ public function get_config_vars($name=null)
+ {
+ return $this->getConfigVars($name);
+ }
+
+ /**
+ * load configuration values
+ *
+ * @param string $file
+ * @param string $section
+ * @param string $scope
+ */
+ public function config_load($file, $section = null, $scope = 'global')
+ {
+ $this->ConfigLoad($file, $section, $scope);
+ }
+
+ /**
+ * return a reference to a registered object
+ *
+ * @param string $name
+ * @return object
+ */
+ public function get_registered_object($name)
+ {
+ return $this->getRegisteredObject($name);
+ }
+
+ /**
+ * clear configuration values
+ *
+ * @param string $var
+ */
+ public function clear_config($var = null)
+ {
+ $this->clearConfig($var);
+ }
+
+ /**
+ * trigger Smarty error
+ *
+ * @param string $error_msg
+ * @param integer $error_type
+ */
+ public function trigger_error($error_msg, $error_type = E_USER_WARNING)
+ {
+ trigger_error("Smarty error: $error_msg", $error_type);
+ }
+
+}
+
+/**
+ * Smarty {php}{/php} block function
+ *
+ * @param array $params parameter list
+ * @param string $content contents of the block
+ * @param object $template template object
+ * @param boolean &$repeat repeat flag
+ * @return string content re-formatted
+ */
+function smarty_php_tag($params, $content, $template, &$repeat)
+{
+ eval($content);
+ return '';
+}
+
+?>
\ No newline at end of file
diff --git a/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/libs/debug.tpl b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/libs/debug.tpl
new file mode 100644
index 000000000..12eef0ffd
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams/ams_lib/smarty/libs/debug.tpl
@@ -0,0 +1,133 @@
+{capture name='_smarty_debug' assign=debug_output}
+
+
+
+ Smarty Debug Console
+
+
+
+
+
Smarty Debug Console - {if isset($template_name)}{$template_name|debug_print_var nofilter}{else}Total Time {$execution_time|string_format:"%.5f"}{/if}
+
+{if !empty($template_data)}
+
included templates & config files (load time in seconds)
+ * - name - name of cycle (optional)
+ * - values - comma separated list of values to cycle, or an array of values to cycle
+ * (this can be left out for subsequent calls)
+ * - reset - boolean - resets given var to true
+ * - print - boolean - print var or not. default is true
+ * - advance - boolean - whether or not to advance the cycle
+ * - delimiter - the value delimiter, default is ","
+ * - assign - boolean, assigns to template var instead of printed.
+ *
This function is beign used to modify the email related to a support group.
+
It will first check if the user who executed this function is an admin. If this is not the case the page will be redirected to an error page. the new email will be validated and in case it's valid we'll add it to the db. Before adding it, we will encrypt the password by using the MyCrypt class. Afterwards the password gets updated and the page redirected again.
It will first check if the user who executed this function is a mod/admin or the topic creator himself. If this is not the case the page will be redirected to an error page. in case the isset($_POST['hidden'] is set and the user is a mod, the message will be hidden for the topic starter. The reply will be created. If $_POST['ChangeStatus']) & $_POST['ChangePriority'] is set it will try to update the status and priority. Afterwards the page is being redirecte to the ticket again.
+ 
+ 
+ 
+
+ 
+
+ 
+
+
+
+
+ 
+
+
+ 
+ 1.7.6.1
+
+
+
+
diff --git a/code/ryzom/tools/server/ryzom_ams_docs/html/logo.png b/code/ryzom/tools/server/ryzom_ams_docs/html/logo.png
new file mode 100644
index 000000000..a072d6eaf
Binary files /dev/null and b/code/ryzom/tools/server/ryzom_ams_docs/html/logo.png differ
diff --git a/code/ryzom/tools/server/ryzom_ams_docs/html/mail__cron_8php.html b/code/ryzom/tools/server/ryzom_ams_docs/html/mail__cron_8php.html
new file mode 100644
index 000000000..d08742e2a
--- /dev/null
+++ b/code/ryzom/tools/server/ryzom_ams_docs/html/mail__cron_8php.html
@@ -0,0 +1,134 @@
+
+
+
+
+
+