Logic is art

alexandermakhno.com

2009-01-27T01:36:00.000-08:00

Hi :) it seems blogging is a good idea.
As from today we are moving on a professional hosting.
Nice domain name, file storage for code snippets etc.
As usual you are welcome on this new address, thank you :)

alexandermakhno.com

PHP - Upload Progress Meter extension

2009-01-23T02:21:00.000-08:00

Yesterday Christian Stocker - Developer at PHP developers group released uploadprogress 0.9.2 extension. The main new function since 0.9.1 is uploadprogress_get_contents($id) which allows you to analyse the content of an uploading file during the upload and do appropriate measure (for example warn the use, that he doesn't upload a supported video format).

Let's try it... We can download it from here
http://cvs.php.net/viewvc.cgi/pecl/uploadprogress/examples/
Also we have to install uploadprogress extension. Let's see how to do it for Windows:
The extension provides the VisualStudio V6 project file: uploadprogress.dsp
http://cvs.php.net/viewvc.cgi/pecl/uploadprogress/
To compile the extension we open this file using VisualStudio, select the apropriate configuration for our installation (either "Release_TS" or "Debug_TS") and create "php_uploadprogress.dll" - put it to the directory (C:\PHP\extensions).

What are podcasts?

2009-01-21T03:57:00.000-08:00

A podcast is a series of audio or video digital media files which is destributed over the Internet by syndicated download. Basically it's like an RSS feed only the information is in digital format :) Very usefull if you are planning trip and want to listen some about the IT news whatever )) Interesting that podcast is distinguished from most other digital media formats by its ability to be syndicated, subscribed to, and downloaded automatically when new content is added. It's better to try on vacations or a trip.

I actually use these podcasts:
from Dustin Diaz and
from Paul (this second one seems to be more complex).

Filestore for a new blog

2009-01-15T06:09:00.001-08:00

It seems blogging is a good idea, actually you get a chance to be criticized by the entire world :) So, the better your next thoughts will be. Just planning to get a nice domain name for a new blog. Seems .com will serve well :)
Now create a simple filestore for the blog. Feeling that it's not totally safe but will see how it works for now. I've used some classes for file managing from Zend Framework snippets (Edit -> Show Snippets) to save the time.

I've used Zend Snippets class for representing files list.
Also used class for file uploading. The function move_uploaded_file is used on the upload stage. This function checks whether the file was uploaded by the HTTP POST protocol. If yes - it will be moved to a new place. If no - the false will be returned and file won't be moved anywhere.

Believe the mini filestore will serve well for code snippets and some pdf files :)

SimpleXML library in PHP5

2009-01-15T05:17:00.000-08:00

SimpleXML is good if we work with not mixed content. SimpleXML is much easier then DOM. It's good if we explicitely know structure of the document, but if not - XPath can make good help in that.

For the first we analize XML document and save it in variable:


$rss =  simplexml_load_file('http://partners.userland.com/nytRss/nytHomepage.xml');

And now we can call for the title of the channel with:


$title =  $rss->channel->title;

The same with other nodes :)

PHP5 (exceptions)

2009-01-15T02:22:00.000-08:00

As from PHP5 we have possibility to throw and catch exceptions in try blocks. There is support "catch all" but not "finally".

On one "try" block can be many "catch" blocks and its will be viewed till the first coincidence with class of the exception and class pointed in the "catch" block. Comparison is done with "instanceof" operator.

As an example we can use the code:


<?php
class MyException extends Exception {
    function display() {
        echo 'MyException: ' . $this->getMessage() . "\n";
    }
}

class MyExceptionFoo extends MyException {
    function display() {
        echo 'MyExceptionFoo: ' . $this->getMessage() . "\n";
    }
}

try {
    throw new MyExceptionFoo("the exception");
} catch (MyException $exception) {
    $exception->Display();
} catch (Exception $exception) {
    echo $exception;
}
?>

The result will be:


MyExceptionFoo: the exception

So, just an object of the exception was created it was catched in the first comparison block. The function display() were overloaded in MyExceptionFoo class and so this function were called. Any user exception-class should have Exception class as a parent.

Exception with database connection: usually we handle error with database connections like this:


$query = mysql_query("SELECT * FROM table") or die(mysql_error());

Now we try to alter the message. Look on the code:


<?php
Class DatabaseException extends Exception {
    public function __construct($msg) {
        parent::__construct($msg);
    }
}
try {
    if (!@$query = mysql_query("SELECT * FROM table")) {
        throw new DatabaseException("Database Query Failed!");
    }
}
catch (DatabaseException $e) {
    echo $e;
}
?>

Constructor of Database Exception class is:


parent::__construct($msg);

Use see that it calls to parent Class Exception and get the message from here. Go ahead, we try to execute query and if it fails an object of the DatabaseException class is created with the message "Database Query Failed!". Go next and on the first (and one :) block "catch" the exception is catched. So the result we'll on the page like:


exception 'DatabaseException' with message 'Database Query Failed!' in T:\home\virtual\second\index.php:9 Stack trace: #0 {main}

As from PHP5 it's quite simple to debug our logic ;)

PHP5 new features

2009-01-14T04:34:00.001-08:00

Now in PHP5 we can enjoy using public/private/protected access modifiers for methods and properties.

Also we got unified constructor name __construct()

Method that triggers every time the object is destroyed __destructor()

Interfaces - very usefull if some people work on a big project and we need classes to be specified so needed methods will present in the class. The syntax is intuitive enough.

To check if the object is an entity of the class we can use instanceof

The "final" keyword say that the method will not be overloaded in inheriting class:


final function getBase() {
 //some logic here
}

Final classes. After declaring a class as final it can't be inherited. If try we'll get an error:


Fatal error: Class BogusClass may not inherit from final class (FinalClass) in T:\home\virtual\second\index.php on line 6

Now we can declare __clone() method which will be called during the clone process (after the properties have been copied from the original object). Let's try it with the code:


<?php
class MyClass {
    private $var;
    
    function __clone() {
        print "Object is being 

cloned<br />";
    }
    
    function __set($name, $value) {
        $this->var = $value;
    }
    
    function __get($name) {
        return $this->var;
    }
}
$obj = new MyClass();
$obj->__set('one', 'some 

value');
echo($obj->__get('one')."

;<br />");

$obj2 = clone $obj;
$obj2->__set('two', 'new 

value');
echo($obj2->__get('two').&quo

t;<br />");
?>

Class constants. We include constant value into the class definition and then use it while referencing the class:


class MyClass {
    const SUCCESS = "Success";
    const FAILURE = "Failure";
}
print MyClass::SUCCESS;

Classes definitions can not include static members (properties), accessible via class:


<?php
class Singleton {
    static private $instance = NULL;

    private function __construct() {
        echo('Object created.<br /><br />'); 
    }

    static public function getInstance() {
        if (self::$instance == NULL) {
            self::$instance = new Singleton();
        }
        return self::$instance;
    }
}

echo('<pre>');
print_r(Singleton::getInstance());
?>

Now we can define static methods and call then from non-object context. We don't use $this with it cause they don't bound to any specific object.

We have now abstract classes :) and abstract methods which defer its definition to an inheriting class. And class that includes abstract methods must be declared as abstract.

Class type hints. If the function are called with an incorrect class type an derror occurs. Let's try it:


<?php
Class MyClass {
    function expectsMyClass(MyClass $obj, ClassTwo $var) {
        echo('<pre>'); 
        print_r($obj);
        print_r($var); 
    }
}

Class ClassTwo {
    function __construct() {
        echo('Object of ClassTwo created!<br />'); 
    }
}

$obj = new MyClass();
$obj2 = new ClassTwo();
$obj->expectsMyClass($obj, $obj2);
?>

Now we can dereference object which are returned from method:


$obj->method()->method2();

PHP classes and PHP extension classes can implement an Iterator interface now. There is SimpleXML - a library that simplifies almost all XML-related operations. The iterator returns a SimpleXML object on each loop, making it more convenient to access XML elements. Let's create an XML document cookbook.xml:


<?xml version="1.0"?>

<cookbook>

  <recipe>
    <name>Chocolate Muffins</name>
    <rating>Yummy</rating>
    <ingredients>Flour, Cocao, Sugar</ingredients>
  </recipe>
  
  <recipe>
    <name>Caramel Cake</name>
    <rating>Sweet</rating>
    <ingredients>Caramel, Flour, lots of love</ingredients>
  </recipe>

</cookbook>

And next use the iterator:


<?php
$data = file_get_contents('cookbook.xml');

foreach ( new SimpleXMLIterator($data) as $recipe ) {
    echo $recipe->name . "\n";
}

?>

Many include_once we can replace with such function now:


<?php
function __autoload($class_name) {
    include_once($class_name . ".php");
}

$obj  = new MyClass1();
$obj2 = new MyClass2();

echo('<pre>'); 
print_r($obj);
print_r($obj2);
?>

The scripting engine is giving a last chance to load the class before PHP get an error. Very nice:


<?php
function __autoload($class_name) {
    include_once($class_name . ".php");
}

$obj  = new MyClass1();
$obj2 = new MyClass2();

echo('<pre>'); 
print_r($obj);
print_r($obj2);
?>

As from PHP5 there is an ability for the well known try/throw/catch structured exception handling paradigm. We are allowed to throw objects which inherit from the Exception class.

We can iterate though an array and modify its values now. Let's use the foreach() loop with the &(reference) sign:


foreach ($array as &$value) {
    if ($value === "NULL") {
        $value = NULL;
    }
}

Giving values to by-reference parameters is now supported. For example the code:


   function square1($number) {
      return $number * $number;
   }

   $val = square1($val);

   function square2(&$number) {
      $number = $number * $number;
   }

   square2($val);
?>

In the first part we passes a copy of $val in, multiplies the copy, return result and copy it back into $val.
In the second part we passes $val in by reference, and it's modified directly inside the function. So, on the line:


$number = $number * $number;

the original $number variable was altered. Slyly enough :)

PHP PEAR framework

2009-01-13T05:19:00.000-08:00

PEAR is a framework and distribution system for reusable PHP components. Don't invent a cycle just attach and use it :) There are many packages with high quality code available for free. Let's try an Archive_Tar one. Include the code to our page (http://pear.php.net/package/Archive_Tar/download):


require("Tar.php");

And use it:


$tar_object = new Archive_Tar("tarname.tar.gz", true);
$v_list[0]="file1.txt";
$v_list[1]="file2.txt";
$tar_object->add($v_list);

Good. On our root folder we get the archive. Simple, isn't it?

Now let's try some work with Stream_Var package. Below we open a stream with our variable (foo). Read some info than write some info (4 symbols). And finally read that variable again, four symbols were replaced ;) Here is the code:


<?php
require_once "Stream/Var.php";
stream_wrapper_register( "var", "Stream_Var" );

$foo = "I really like tomatoes.";
echo "Content of foo: $foo<br />";

$fp = fopen('var://GLOBALS/foo','r+');
$data = fread($fp, 9);
echo "Read from stream: $data<br />";

fwrite($fp,"hate");
fclose($fp);
echo "Content of foo: $foo<br />";
?>

On the page we can see the following:


Content of foo: I really like tomatoes.
Read from stream: I really
Content of foo: I really hate tomatoes.

And here is an example shows how to use opendir() to access an array:


<?php
require_once "Stream/Var.php";
stream_wrapper_register( "var", "Stream_Var" );
$dirname = 'var://_SERVER';
$dir = opendir($dirname);
echo    "<strong>opening directory '$dirname'</strong><br><br>";

while ($entry = readdir($dir)) {
    echo "opening file $dirname/$entry<br />";
    if (!$fp = @fopen($dirname."/".$entry,"r")) {
        echo "seems to be a directory<br /><br />";
        continue;
    }
       
    echo "reading from $entry<br />";
    while (!feof($fp)) {
        echo fread($fp, 16);
    }
    fclose($fp);
    echo    "<br /><br />";
}
closedir($dir);
?>

JSON-PHP utility from Michal Migurski

2009-01-13T03:29:00.001-08:00

http://www.json.org/

And one more utility :) We need PEAR (PHP Extension and Application Repository) library for work with the utility.

We can download utility from here: http://pear.php.net/pepr/pepr-proposal-show.php?id=198

Let's create an html page and include JSON.php file of the utility:


<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

class Auto {
 public $firm;
 public $model;
 public $year;
 public $price;
 public $sellers;
 
 function Auto($firm, $model, $year, $price) {
  $this->firm = $firm;
  $this->model = $model;
  $this->year = $year;
  $this->price = $price;
  $this->sellers = array();
 }
}

$oAuto = new Auto("Audi", "A6", 2008, 78000);
$oAuto->sellers[0] = "Фирма А";
$oAuto->sellers[1] = "Фирма Б";
$oAuto->sellers[2] = "Фирма В";

echo "Исходный объект: ";
print_r($oAuto);

require_once('JSON.php');

Create an object and get encoded line in format JSON:


$json = new Services_JSON();

$sJSONText = $json->encode($oAuto);

echo "Строка в формате JSON: ".$sJSONText;

And decode it back to the object:


$value = $json->decode($sJSONText);

echo "Объект из строки JSON: ";
print_r($value);

Work nice :) on the page we'll get something like this:


Исходный объект: Auto Object ( [firm] => Audi [model] => A6 [year] => 2008 [price] => 78000 [sellers] => Array ( [0] => Фирма А [1] => Фирма Б [2] => Фирма В ) )

Строка в формате JSON: {"firm":"Audi","model":"A6","year":2008,"price":78000,"sellers":["\u0424\u0438\u0440\u043c\u0430 \u0410","\u0424\u0438\u0440\u043c\u0430 \u0411","\u0424\u0438\u0440\u043c\u0430 \u0412"]}

Объект из строки JSON: stdClass Object ( [firm] => Audi [model] => A6 [year] => 2008 [price] => 78000 [sellers] => Array ( [0] => Фирма А [1] => Фирма Б [2] => Фирма В ) )

Here is some info: http://www.json.org/

JSON utility from Douglas Crockford

2009-01-13T02:36:00.000-08:00

JSON is a lightweight computer data interchange format. It's a text-based, human-readable format for representing simple data structures and associative arrays (called objects).

The JSON format is specified by Douglas Crockford. The JSON file extension is .json.

Data in JSON format is more readable and takes less bytes then XML.

Douglas Crockford created an utility for work with converting data from and to JSON format. Let's try it now :)

Original code can be downloaded from here: http://www.linkexchanger.su/example_json/json.zip

On our html page put link to the utility code:


<script type="text/javascript" src="json.js"></script>

Then we create an Object OAuto using literal notation:


var oAuto = new Object();
oAuto.firm = "Audi";
oAuto.model = "A6";
oAuto.year = 2008;
oAuto.price = 78000;
oAuto.sellers = new Array(
  "Фирма А",
  "Фирма Б",
  "Фирма В"
);

Give object to the method JSON.stringify()


document.write(JSON.stringify(oAuto));

We'll get string in JSON format which can send to any address :)


{"firm":"Audi","model":"A6","year":2008,"price":78000,
"sellers":["Фирма А","Фирма Б","Фирма В"]}

And lets do it the other: we got answer from the server and convert it to JavaScript object:


var oAuto = JSON.parse(sAuto);

And get JavaScript Object. Great ;)

The result will be something like this:


{"firm":"Audi","model":"A6","year":2008,"price":78000,"sellers":["Фирма А","Фирма Б","Фирма В"]}

Автомобиль Audi A6 2008 года выпуска, цена 78000 евро.
Продавцы: Фирма А, Фирма Б, Фирма В.

PHP5 overload set(), get(), call()

2009-01-12T08:05:00.001-08:00

One more new feature in PHP5 has become overloading. Using magic methods __set(), __get(), __call() we can overload calls to properties and methods. __get() and __set() are called while setting and getting the value, and __call() while calling the method that doesn't exist in the class.
But the magic functions will be called only when target method / property doesn't exist.

Here is some example (I've grabbed it from the internet) of usage __set() and __get:


<?php
class Setter {
    public $n;
    public $x = array('a' => 1, 'b' => 2, 'c' => 3);

    function __set($nm, $val) {
        echo "Set [$nm] to $val\n<br />";
        if (isset($this->x[$nm])) {
            $this->x[$nm] = $val;
            echo "Good!\n<br /><br />";
        }
        else { echo "Bad!\n<br /><br />"; }
    }

    function __get($nm) {
        echo "Get [$nm]\n<br />";
        if (isset($this->x[$nm])) {
            $r = $this->x[$nm];
            echo "Return: $r\n<br /><br />";
            return $r;
        }
        else { echo "Empty!\n<br /><br />"; }
    }
}

$foo = new Setter();
$foo->n = 1;
$foo->a = 100;
$foo->a++;
$foo->z++;

echo('<pre>');
var_dump($foo);
?>

Result will be the next:


Set [a] to 100
Good!

Get [a]
Return: 100

Set [a] to 101
Good!

Get [z]
Empty!

Set [z] to 1
Bad!

object(Setter)#1 (2) {
  ["n"]=>
  int(1)
  ["x"]=>
  array(3) {
    ["a"]=>
    int(101)
    ["b"]=>
    int(2)
    ["c"]=>
    int(3)
  }
}

And magic __call() method is called with two parameters: name of the method and array of the parameters:


<?php
class Caller {
    public $x = array(1, 2, 3);

    function __call($m, $a) {
        echo "Method $m called:\n";
        echo('<pre>'); 
        var_dump($a);
        echo('<hr>'); 
        return $this->x;
    }
}

$foo = new Caller();
$a = $foo->test(1, "2", 3.4, true);
echo "Returned value:\n";
echo('<pre>'); 
var_dump($a);
?>

And the result is next:


Method test called:

array(4) {
  [0]=>
  int(1)
  [1]=>
  string(1) "2"
  [2]=>
  float(3.4)
  [3]=>
  bool(true)
}
Returned value:

array(3) {
  [0]=>
  int(1)
  [1]=>
  int(2)
  [2]=>
  int(3)
}

What is the good from all of this? And again less and more laconic code. Good...

GD library (russian text on the image)

2009-01-08T09:47:00.000-08:00

This post is an improvement of the previous post in December "GD library (text on the image)". Just felt it should be enhanced :)

Hi! While working on the interesting project we needed a function which will create many lines from the one. For example we have "one two three four five" and want to get:


one two
three four
five

Just decided to write down created function for the future :) feeling that it's not the best but that's it :)
So the function is something like this:


protected function _line_to_lines($line, $letters_in_line = 40, $font_size) {
        if (mb_strlen($line, "UTF-8") < $letters_in_line) {
            $res_lines = $this->_replace_cyr(trim($line));
        }
        else {
            $ar_lines = explode(" ", $line);
            $how_many = count($ar_lines);
            $num_lines = 0;
            $k = 0;
            $one_line = $ar_lines[0];
            for ($i = 1; $i < $how_many; $i++) {
                if (mb_strlen($one_line." ".$ar_lines[$i], "UTF-8") < $letters_in_line) {
                    $one_line .= " ".$ar_lines[$i];
                }
                else {
                    $res_lines[$k] = $this->_replace_cyr(trim($one_line));
                    $one_line = $ar_lines[$i];
                    $k++;
                }
                $end_line = $one_line;
            }
            $res_lines[$k] = $this->_replace_cyr(trim($end_line));
            $num_lines = count($res_lines);
            $res_lines = implode("\n\r", $res_lines);

            //this check for russian encoded text only
            if (mb_strstr($res_lines, "&#", 0, "UTF-8") && (mb_strlen($res_lines, "UTF-8") > 1000)) { 
                //cut off all symbols after 1000
                $res_lines = mb_substr($res_lines, 0, 1000, "UTF-8");
                $last_amp = mb_strrpos($res_lines, "&");
                $res_lines = mb_substr($res_lines, 0, $last_amp, "UTF-8");

                ($num_lines > 5) ? ($num_lines = 5) : '' ;          //set cutted height
            }
            $height = $num_lines * ($font_size + 8);
        }
        
        return array($res_lines, $height);
    }

and notice that one more function is called here _replace_cyr. This function convers russian letters to their HTML entities. Cause if we want to put some russian text on the image with GD library in PHP. So we have to convert russian letters and only then put it on the image:


protected function _replace_cyr($path){
   $search = array ("'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð '", "'Ð¡'", "'Ð¢'", "'Ð£'", "'Ð¤'", "'Ð¥'", "'Ð¦'", "'Ð§'", "'Ð¨'", "'Ð©'", "'Ðª'", "'Ð«'", "'Ð¬'", "'Ð'", "'Ð®'", "'Ð¯'", "'Ð°'", "'Ð±'", "'Ð²'", "'Ð³'", "'Ð´'", "'Ðµ'", "'Ð¶'", "'Ð·'", "'Ð¸'", "'Ð¹'", "'Ðº'", "'Ð»'", "'Ð¼'", "'Ð½'", "'Ð¾'", "'Ð¿'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'0'e");
   $replace = array ('&#1025;', '&#1040;', '&#1041;', '&#1042;', '&#1043;', '&#1044;', '&#1045;', '&#1046;', '&#1047;', '&#1048;', '&#1049;', '&#1050;', '&#1051;', '&#1052;', '&#1053;', '&#1054;', '&#1055;', '&#1056;', '&#1057;', '&#1058;', '&#1059;', '&#1060;', '&#1061;', '&#1062;', '&#1063;', '&#1064;', '&#1065;', '&#1066;', '&#1067;', '&#1068;', '&#1069;', '&#1070;', '&#1071;', '&#1072;', '&#1073;', '&#1074;', '&#1075;', '&#1076;', '&#1077;', '&#1078;', '&#1079;', '&#1080;', '&#1081;', '&#1082;', '&#1083;', '&#1084;', '&#1085;', '&#1086;', '&#1087;', '&#1088;', '&#1089;', '&#1090;', '&#1091;', '&#1092;', '&#1093;', '&#1094;', '&#1095;', '&#1096;', '&#1097;', '&#1098;', '&#1099;', '&#1100;', '&#1101;', '&#1102;', '&#1103;', '&#1105;', '0');
   return preg_replace ($search,$replace,$path);
  }

That strange symbols are russian letters ;)

So as a result we'll get many lines from one line. The lines will be encoded to HTML entities. And also we'll get total height of that lines - for the allocation on the image :)

Firefox3 (create an extension)

2008-12-30T02:44:00.000-08:00

Let's create an extension for the Firefox browser. Firefox's user interface is written in XUL and JavaScript. XUL files are used in Firefox to describe overlays. For example if we print in address bar something like this:


chrome://browser/content/browser.xul

Yep :) one more browser in our browser )) There is an overlay of Firefox browser.
OK. And we go...
We create a folder for our extension somewhere on hard disk C:\extensions\myextension insite create a folder called chrome and inside the chrome folder create a folder called content. Inside the root directory create two new empty text files, one called chrome.manifest and the other called install.rdf. Finally we'll get something like this:


\
          install.rdf
          chrome.manifest
          chrome\
             content\

Now create the install manifest. Open install.rdf file and put this code:


<?xml version="1.0"?>

<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
     xmlns:em="http://www.mozilla.org/2004/em-rdf#">

  <Description about="urn:mozilla:install-manifest">
    <em:id>sample@example.net</em:id>
    <em:version>1.0</em:version>
    <em:type>2</em:type>
   
    <!-- Target Application this extension can install into, 
         with minimum and maximum supported versions. --> 
    <em:targetApplication>
      <Description>
        <em:id>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</em:id>
        <em:minVersion>1.5</em:minVersion>
        <em:maxVersion>3.0.*</em:maxVersion>
      </Description>
    </em:targetApplication>
   
    <!-- Front End MetaData -->
    <em:name>sample</em:name>
    <em:description>A test extension</em:description>
    <em:creator>Your Name Here</em:creator>
    <em:homepageURL>http://www.example.com/</em:homepageURL>
  </Description>      
</RDF>

Notice: sample@example.net - the ID of our extension. And {ec8030f7-c20a-464f-9b0e-13a3a9e97384} - Firefox's application ID. Please set maximum ver. of the Firefox as your one. About this:


<em:maxVersion>3.0.*</em:maxVersion>

Now add some data to chrome.manifest file. Add lines:


content     sample    chrome/content/
overlay chrome://browser/content/browser.xul chrome://sample/content/sample.xul

In folrder chrome/content create your layout sample.xul with code:


<?xml version="1.0"?>
<overlay id="sample" 
         xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
 <statusbar id="status-bar">
  <statusbarpanel id="my-panel" label="Happy New Year!!!"/>
 </statusbar>
</overlay>

And tell Firefox to add the extension create a file. For this lets open current Firefox profiles. Just print in "Run" (command line in Windows) somethins like this: %appdata%. Actually on my machine the path is:
C:\Documents and Settings\amak\Application Data\Mozilla\Firefox\Profiles\66q2ksw1.default\extensions
Create there a file "sample@example.net" name like id of our extention. And put in the file line:


C:\extensions\myextension\

Restart Firefox and look into the status bar of our browser.

Firefox3 (create search plugin)

2008-12-29T05:31:00.001-08:00

There is a convenient search bar in the right top corner of the Firefox. There is limited number of search plugins, sometimes we want to add one more. Very good that it's easy and quick :)
For example we want to have search on our blog. Let's do it now. In Firefox3 search plugins are in installation folder: Mozilla Firefox\searchplugins. Just look on the existent one and alter it a little. For example google search:


<SearchPlugin xmlns="http://www.mozilla.org/2006/browser/search/">
<ShortName>Google</ShortName>
<Description>Google Search</Description>
<InputEncoding>UTF-8</InputEncoding>
<Image width="16" height="16">data:image/x-icon;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAIAAACQkWg2AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAaRJREFUeNpiVIg5JRURw0A0YAHio943kYV%2B%2Ff33%2BdvvX7%2F%2FMjEx8nKycrGzwKXOiPKzICvdeezLhCV3jp15%2Bfv%2FX0YGhv8MDDxMX2qKTIw0RK10eYD6QYqATvoPBkt3f5K0W9Ew4fjTFz%2F%2Bw8Dm3W8UPeZxqFa%2BevsFyD0twgfVsOfkRxHrtfV9u5BVQ8Crd98%2FffkGYQM1QJ20%2FfSPv79eNxQGYfpSVJADmcvEAHbr7oOX2dj%2FERNKIA2%2F%2F%2Fz%2FxfCDhYVoDUDw5P6vf9%2B5iY0HVmZGQWm%2BN3fff%2Fn2k4eLHS739x%2FDiRs%2Ff%2F%2F5x8HO%2FOHzN3djfqgNjIwMgc6qzLx%2Fpy47j2zY%2Feff06tXhOUucgxeun33AUZGpHh4%2Bvo7t8EyIJqz%2FhpasD59%2B5dNrqdnznZIsEL9ICXCsWuBCwvTv%2FymS5PWPP32ExEALz%2F%2BB5r848cPCJcRaMP9xaYQzofPPzfuvrnj0Jst%2B5%2F8%2Bc4sLPeDkYlRgJc93VPE18NIXkYUmJYQSQMZ%2FP3379uPH7%2F%2F%2FEETBzqJ0WqLGvFpe2LCC4AAAwAyjg7ENzDDWAAAAABJRU5ErkJggg%3D%3D</Image>
<Url type="application/x-suggestions+json" method="GET" template="http://suggestqueries.google.com/complete/search?output=firefox&client=firefox&hl={moz:locale}&q={searchTerms}"/>
<Url type="text/html" method="GET" template="http://www.google.com/search">
  <Param name="q" value="{searchTerms}"/>
  <Param name="ie" value="utf-8"/>
  <Param name="oe" value="utf-8"/>
  <Param name="aq" value="t"/>
  <!-- Dynamic parameters -->
  <Param name="rls" value="{moz:distributionID}:{moz:locale}:{moz:official}"/>
  <MozParam name="client" condition="defaultEngine" trueValue="firefox-a" falseValue="firefox"/>
</Url>
<SearchForm>http://www.google.com/firefox</SearchForm>
</SearchPlugin>

XML document ;) tags names are nice. Maybe the most interesting for us are tag IMG. The image is embedded inside a PHP script. There is a magic program that base64-encodes images and generated PHP code that represents the image. So, now we don't need keep pic image just encode it and paste into the plugin code :)
Here is the program: http://php.holtsmark.no/base64img/
The result of the program will something like this:


<?
# Copy and paste this code
# into the TOP of your
# php-script!

  function img() 
  {
    header("Content-type: image/png");
    header("Content-length: 676");
    echo base64_decode(
'iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAAX'.
'NSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAgY0hSTQAAeiYA'.
'AICEAAD6AAAAgOgAAHUwAADqYAAAOpgAABdwnLpRPAAAAiJJRE'.
'FUOE+llEtIVFEYx88UMzlZQhAktGiRuK0WbaJyUbloHUWY44w6'.
'L5uJwjaBG3e2ylpF1KLJKattLyipbClYmFIalUwvQWigpjJ1/P'.
'V9XYc7N+dO2Rz4w+Xcc37ne3uMrJuH6vdsr57q3+T7st4s6M4y'.
'lseYvMdnxr6vS29JTQXMnaa6xlzYlyNuIFKBEh5eB2tSJhNa+9'.
'kV1i4PtBUpXObBqCHX5s0bYiUOtcpesyi6ApJrLHWsghbZU7l5'.
'IlCz5KdeOFkL98/A5BB8HBONQuYZDPVDzw4IuEOdQLWscyO8k8'.
'tuayYHvftcoU6gujlw1h1W+JMZlhCstuL7h/s2UBMQ9TqtG7wg'.
'Lu4S7YTrx2H+p4XMz0HXZjgod/ReEdQG6mvHJPgas8IaOAfd20'.
'RbIdVuA/X/vR44vdtKWBHUCUxWw4fnf3e5+MSlI1ZFLFpZOfDq'.
'0WUAp9/AyC0YvWtp5DZMPIa5GdvGvngZYMLvjOG1JBwWd0KLUt'.
'cSkt1PL4uAMRegtlXIAy8e2Iez72H8oVg1aEm/30qxz8/aZ3r3'.
'ugA1qNoB5w/8e1JePYG4sx6dhf3bStGNE/AtWx48/ghO1UHQrQ'.
'4Lxak1pf3cVQ8XmyDdAX0SJ1VaEnAlIq3XKJ1StQSmpWPyMV/p'.
'6aEvaxLcVKLtdDqZp4ENaWQ4IqOnsgFrmG71Z0xDQ0vVZLDm8t'.
'eI98f/QheiK8mG/RPDzbX7fwF4qkabb2dNhgAAAABJRU5ErkJg'.
'gg=='.
'');
  }
# Above is the code of
# your image..

# Here is a Example:
# This is the phpcode to
# execute function img(); :
  if ( array_key_exists("image", $_REQUEST) && $_REQUEST["image"]==1) { img(); die(); }

# End PHP ?>
  <img src=<?php echo $_SERVER["PHP_SELF"]; ?>?image=1><br> 
  Created with <a href=http://php.holtsmark.no>
  base64img.php</a>

And we'll need that some encoded lines. I've joined that lines in one line and get something like this:


iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAgY0hSTQAAeiYAAICEAAD6AAAAgOgAAHUwAADqYAAAOpgAABdwnLpRPAAAAiJJREFUOE+llEtIVFEYx88UMzlZQhAktGiRuK0WbaJyUbloHUWY44w6L5uJwjaBG3e2ylpF1KLJKattLyipbClYmFIalUwvQWigpjJ1/PV9XYc7N+dO2Rz4w+Xcc37ne3uMrJuH6vdsr57q3+T7st4s6M4ylseYvMdnxr6vS29JTQXMnaa6xlzYlyNuIFKBEh5eB2tSJhNa+9kV1i4PtBUpXObBqCHX5s0bYiUOtcpesyi6ApJrLHWsghbZU7l5IlCz5KdeOFkL98/A5BB8HBONQuYZDPVDzw4IuEOdQLWscyO8k8tuayYHvftcoU6gujlw1h1W+JMZlhCstuL7h/s2UBMQ9TqtG7wgLu4S7YTrx2H+p4XMz0HXZjgod/ReEdQG6mvHJPgas8IaOAfd20RbIdVuA/X/vR44vdtKWBHUCUxWw4fnf3e5+MSlI1ZFLFpZOfDq0WUAp9/AyC0YvWtp5DZMPIa5GdvGvngZYMLvjOG1JBwWd0KLUtcSkt1PL4uAMRegtlXIAy8e2Iez72H8oVg1aEm/30qxz8/aZ3r3ugA1qNoB5w/8e1JePYG4sx6dhf3bStGNE/AtWx48/ghO1UHQrQ4Lxak1pf3cVQ8XmyDdAX0SJ1VaEnAlIq3XKJ1StQSmpWPyMV/p6aEvaxLcVKLtdDqZp4ENaWQ4IqOnsgFrmG71Z0xDQ0vVZLDm8teI98f/QheiK8mG/RPDzbX7fwF4qkabb2dNhgAAAABJRU5ErkJggg==

Then paste this code into the img tag something like this:


<Image width="16" height="16">data:image/x-icon;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAgY0hSTQAAeiYAAICEAAD6AAAAgOgAAHUwAADqYAAAOpgAABdwnLpRPAAAAiJJREFUOE+llEtIVFEYx88UMzlZQhAktGiRuK0WbaJyUbloHUWY44w6L5uJwjaBG3e2ylpF1KLJKattLyipbClYmFIalUwvQWigpjJ1/PV9XYc7N+dO2Rz4w+Xcc37ne3uMrJuH6vdsr57q3+T7st4s6M4ylseYvMdnxr6vS29JTQXMnaa6xlzYlyNuIFKBEh5eB2tSJhNa+9kV1i4PtBUpXObBqCHX5s0bYiUOtcpesyi6ApJrLHWsghbZU7l5IlCz5KdeOFkL98/A5BB8HBONQuYZDPVDzw4IuEOdQLWscyO8k8tuayYHvftcoU6gujlw1h1W+JMZlhCstuL7h/s2UBMQ9TqtG7wgLu4S7YTrx2H+p4XMz0HXZjgod/ReEdQG6mvHJPgas8IaOAfd20RbIdVuA/X/vR44vdtKWBHUCUxWw4fnf3e5+MSlI1ZFLFpZOfDq0WUAp9/AyC0YvWtp5DZMPIa5GdvGvngZYMLvjOG1JBwWd0KLUtcSkt1PL4uAMRegtlXIAy8e2Iez72H8oVg1aEm/30qxz8/aZ3r3ugA1qNoB5w/8e1JePYG4sx6dhf3bStGNE/AtWx48/ghO1UHQrQ4Lxak1pf3cVQ8XmyDdAX0SJ1VaEnAlIq3XKJ1StQSmpWPyMV/p6aEvaxLcVKLtdDqZp4ENaWQ4IqOnsgFrmG71Z0xDQ0vVZLDm8teI98f/QheiK8mG/RPDzbX7fwF4qkabb2dNhgAAAABJRU5ErkJggg==</Image>

Also there are two types of tag URL:
text/html
application/x-suggestions+json

text/html for our search query
application/x-suggestions+json for drop down list with search suggestions (like in Google)
I've deleted second one cause seems there is no such service on my blog.
And first one is like this:


<Url type="text/html" method="GET" template="http://www.google.com/search">

Google search page address.
And in params we have one with name="q". This is query that will be added to the search line. So lets put there our code:


<Param name="q" value="logic-is-art.blogspot.com: {searchTerms}"/>

It's not a secret that if we want Google to search within only one website we can do it like this


oursite.com: searchme

So, this {searchTerms} will be a word that we'll type into the search field.
That's all. Don't forget to restart a fox. Enjoy :)

And one more plugin Lingvo online dictionary. Here is a code:


<SearchPlugin xmlns="http://www.mozilla.org/2006/browser/search/">
<ShortName>Lingvo</ShortName>
<Description>Lingvo</Description>
<InputEncoding>UTF-8</InputEncoding>
<Image width="16" height="16">data:image/x-icon;base64,/9j/4AAQSkZJRgABAQEASABIAAD/4QCURXhpZgAASUkqAAgAAAADADEBAgAcAAAAMgAAADIBAgAUAAAATgAAAGmHBAABAAAAYgAAAAAAAABBZG9iZSBQaG90b3Nob3AgQ1MzIFdpbmRvd3MAMjAwODowODoxMiAwOTozOTozNgADAAGgAwABAAAA//8AAAKgBAABAAAANwEAAAOgBAABAAAALAEAAAAAAAD/2wBDAAICAgICAQICAgIDAgIDAwYEAwMDAwcFBQQGCAcJCAgHCAgJCg0LCQoMCggICw8LDA0ODg8OCQsQERAOEQ0ODg7/2wBDAQIDAwMDAwcEBAcOCQgJDg4ODg4ODg4ODg4ODg4ODg4ODg4ODg4ODg4ODg4ODg4ODg4ODg4ODg4ODg4ODg4ODg7/wAARCAAUABQDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwD2r9vb4n/EbwZ8XvD0Hgb4ja94NW6027M9tpmrS24mddQuIxJhXHIWNVB7DA4r4B8FftP/ALROofFaw834v+MLuyhjYyQXOu3LxTEDHzKH5BYrkA+2a/VT9qH4TeH/AIj/ABt0Q67Y2NwsNtdR25m0ya7uP+P+8chFS4iUgsUyrZ9QeMH5g1P9nD4Y2+kwanbPrI09YntYo9CsNPsY5G3b2YyXV+2WUBeh/i6V8liY1pYifs38r+R/SfDeOyGhkEFXhHmS96Timk23a76dNND6y/Za+JPxB8c/BbxXq/ivxFfXN/F4rmtoR50qJHEtrbEKgd2IXLMevUk0V1v7MPwk1DwN8A9W0nTdI1O1t5tekuiNburSSdy9vANwNsxQJ8owM54Oe1Fe3h41VRip7n5DmlbBTzCpKk48t9LWS+S1/NnU/E34T6d8R/2ndN1G88Ua/wCG7rTLeW3t30Oe3iJDXMkhLGSGQk5cjggY7Z5rr7H9kzwBHpkdrqvi7x34itFIaOC/8VSJFGRz8qQLGq9B0HYelFFcyhD6zPTdnrUf9myWEqPuOWra0bd93bd+Z7L4T+GPhDwV4cm0rQbS7itJbg3En2nU7i4dpCqqTukdj0ReM4/M0UUV7KjFKyR+eVatWdRylJtvuz//2Q==</Image>
<Url type="text/html" method="GET" template="http://www.abbyyonline.ru/Translate.aspx">
  <Param name="words" value="{searchTerms}"/>
  <Param name="ie" value="utf-8"/>
  <Param name="oe" value="utf-8"/>
  <Param name="aq" value="t"/>
  <!-- Dynamic parameters -->
  <Param name="rls" value="{moz:distributionID}:{moz:locale}:{moz:official}"/>
  <MozParam name="client" condition="defaultEngine" trueValue="firefox-a" falseValue="firefox"/>
</Url>
<SearchForm>http://www.google.com/firefox</SearchForm>
</SearchPlugin>

PHP bug (mb_substr)

2008-12-23T08:02:00.000-08:00

Function mb_substr has optional parameters.


string mb_substr  ( string $str  , int $start  [, int $length  [, string $encoding  ]] )

If we have to substr line from 3rd character to the end we can write something like this:


mb_substr('foobar', 3)

If we have to do the same and also to point encoding explicitly, so the 3rd optional parameter in function will be missed


mb_substr('foobar', 3, null, "UTF-8")

We'll get empty string. It's a bug: http://bugs.php.net/bug.php?id=40531&edit=1


Reproduce code:
---------------
var_dump(mb_substr('foobar', 3));
var_dump(mb_substr('foobar', 3, null));

Expected result:
----------------
'bar' (length=3)
'bar' (length=3)

Actual result:
--------------
'bar' (length=3)
'' (length=0)

I've used it something like this in my code:


//this count for next line because of the bug http://www.mail-archive.com/php-bugs@lists.php.net/msg94686.html
   $count_it = mb_strlen($line, "UTF-8");
            $line = mb_substr($line, $letters_in_line, $count_it, "UTF-8");

One superfluous operation because of it...

GD library (text on the image)

2008-12-23T07:23:00.000-08:00

Let's add some text to the image. We can use functions imagestring() and imagettftext(). What is the difference? Function imagestring() can add only one line text. So to add many lines we have to divide the text on lines add it to the massive and than to run in cycle function imagestring(). Also this function requires special php-coverted fonts. There is good program for that http://mysitez.km.ua/Downloads/
Function imagettftext() can work with .ttf fonts from Windows folder. Also this function can write multiline text like this:


first line\n\rsecond line

There is some info on the website about this functions. But... Not on every machine it'll be work. Why? I've spent a lot of time searching for the problem. On different machines it works quite different. Actually it don't work at all on some one. Very nice :)
Interesting that if source file is ANSI it works sometimes. So let's find more universal code.
Finally we've get a code that works on UTF-8, ANSI and all other...
There is some interesting functions in it. There is a function for dividing text on the lines:


protected function _line_to_lines($line, $letters_in_line = 40, $font_size) {
        $count_lines = ceil(mb_strlen($line, "UTF-8") / $letters_in_line);
        $height = $count_lines * ($font_size + 8);
        $res = "";
        for ($i = 0; $i < $count_lines; $i++) {
            $one_line = mb_substr($line, 0, $letters_in_line, "UTF-8");
   $one_line = $this->_replace_cyr($one_line);
            $res .= $one_line."\n\r";

   //this count for next line because of the bug http://www.mail-archive.com/php-bugs@lists.php.net/msg94686.html
   $count_it = mb_strlen($line, "UTF-8");

            $line = mb_substr($line, $letters_in_line, $count_it, "UTF-8");
        }
        return array($res, $height);
    }

In this code we created a bibb for the PHP bug (about that bug in the next post)
Also we do have to use "mb_" prefix for functions for working with strings. And do not forget to set encoding so the string symbols will be cutted correctly.

In next function we convert string from cyrilic symbols to codes


protected function _replace_cyr($path){
        $search = array ("'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð�'", "'Ð '", "'Ð¡'", "'Ð¢'", "'Ð£'", "'Ð¤'", "'Ð¥'", "'Ð¦'", "'Ð§'", "'Ð¨'", "'Ð©'", "'Ðª'", "'Ð«'", "'Ð¬'", "'Ð'", "'Ð®'", "'Ð¯'", "'Ð°'", "'Ð±'", "'Ð²'", "'Ð³'", "'Ð´'", "'Ðµ'", "'Ð¶'", "'Ð·'", "'Ð¸'", "'Ð¹'", "'Ðº'", "'Ð»'", "'Ð¼'", "'Ð½'", "'Ð¾'", "'Ð¿'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'Ñ�'", "'0'e");
        $replace = array ('&#1025;', '&#1040;', '&#1041;', '&#1042;', '&#1043;', '&#1044;', '&#1045;', '&#1046;', '&#1047;', '&#1048;', '&#1049;', '&#1050;', '&#1051;', '&#1052;', '&#1053;', '&#1054;', '&#1055;', '&#1056;', '&#1057;', '&#1058;', '&#1059;', '&#1060;', '&#1061;', '&#1062;', '&#1063;', '&#1064;', '&#1065;', '&#1066;', '&#1067;', '&#1068;', '&#1069;', '&#1070;', '&#1071;', '&#1072;', '&#1073;', '&#1074;', '&#1075;', '&#1076;', '&#1077;', '&#1078;', '&#1079;', '&#1080;', '&#1081;', '&#1082;', '&#1083;', '&#1084;', '&#1085;', '&#1086;', '&#1087;', '&#1088;', '&#1089;', '&#1090;', '&#1091;', '&#1092;', '&#1093;', '&#1094;', '&#1095;', '&#1096;', '&#1097;', '&#1098;', '&#1099;', '&#1100;', '&#1101;', '&#1102;', '&#1103;', '&#1105;', '0');
        return preg_replace ($search,$replace,$path);
    }

not nice here. Original code is http://omsk777.ru/all.php?act=ttf

And in code we'll create an image like this


header('Content-type: image/png');
        $im = imagecreatefrompng($source_image);
        $font = str_replace ( "\\", "/", getcwd () )."/fonts/verdana.ttf";
        $black = imagecolorallocate($im_large, 0, 0, 0);

        ImageTtfText ($im_large, $this->fontSize, 0, 5, $this->fontSize + 2, $black, $font, $text[0]);
        imagecopymerge($im_large, $im, $this->thumbTextWidth, 0, 0, 0, $source_size[0], $source_size[1], 100);

        imagepng($im_large, $res_image);
        imagedestroy($im);
        imagedestroy($im_large);

It works very good. I'm happy ;)

TinyMCE (right click context menu)

2008-12-19T14:04:00.000-08:00

And now we want to manage right click context menu. In our case we want to do it for the image. For example, we insert image to text editor and want to get customized menu after clicking right button.
Maybe the most interesting thing to find it by yourself, no Google. Just think :)
The way I've used: open Total Commander and find files with text like "paste" like one of the points in context menu. So in results we see that there is plugin context menu. Nice, go there. Open file editor_plugin_src.js and at the end there is structure of our menu


t._menu = m;

   m.add({title : 'advanced.cut_desc', icon : 'cut', cmd : 'Cut'}).setDisabled(col);
   m.add({title : 'advanced.copy_desc', icon : 'copy', cmd : 'Copy'}).setDisabled(col);
   m.add({title : 'advanced.paste_desc', icon : 'paste', cmd : 'Paste'});

   if ((el.nodeName == 'A' && !ed.dom.getAttrib(el, 'name')) || !col) {
    m.addSeparator();
    m.add({title : 'advanced.link_desc', icon : 'link', cmd : ed.plugins.advlink ? 'mceAdvLink' : 'mceLink', ui : true});
    m.add({title : 'advanced.unlink_desc', icon : 'unlink', cmd : 'UnLink'});
   }

   m.addSeparator();
   m.add({title : 'advanced.image_desc', icon : 'image', cmd : ed.plugins.advimage ? 'mceAdvImage' : 'mceImage', ui : true});

we can add some points, link some event to it and use for our needs :)

TinyMCE (image managing)

2008-12-19T13:35:00.000-08:00

There is no image loader in TinyMCE installation package. We have to point internet location of the image and than a pic will be uploaded. We were looking for a tool for managing images right from the editor interface. Really good and handy one is TinyMCE Image Manager 1.0 plugin from Antonov Andrey
http://tinymce.ru/plugins/tinymce-image-manager-1-0
Let's try it :) Installation process is usual as for the plugin. After that we can see that it seems not to work in FF. Actually on my machine I never see that :)) [WinXP, Firefox 3.0.4, Flash10]
OK, in comments there is some info that we should to use Flash9. And even with that it seems not to work. The same situation is with IE. The plugin is unstable. So, wait for the update...

Let's try something without a flash.

Finally I've selected ibrowser. It's a free plugin for uploading and managing images via timymce interface. Interesting that ibrowser works well with TinyMCE ver.3 also it's good idea to add code like this to file browser/config.inc


$cfg['ilibs'] = array (
         array (
                 'value' => '',
                 'text' => 'Please select folder &darr;',
         ),
         array (
                 'value' => 'images/',
                 'text' => 'Ð�Ð±Ñ�Ð¸Ðµ',
         ),
         array (
                 'value' => 'gallery/',
                 'text' => 'Ð�Ð°Ð»ÐµÑ�ÐµÑ�',
         ),
  );

So when we open the window first selected point in the select box is "Please select folder".
This is cause just after opening the plugin window there are no images in it. We do have to select any folder for images be shown.

TinyMCE (source code journey)

2008-12-17T09:48:00.000-08:00

Do you like a journey? Today we'll go on a tour under a veil of secrecy of TinyMCE source code...
In the previous post "TinyMCE (alter plugin)" we tried to add some functionality. Out task was: to make so that while viewing source code tags like img... be replaced with other one. And after saving the changes it should be replaced back. We took a plugin from here http://danielinsley.com and altered it a little. But the plugin doesn't work for IE.
So, there is obvious two ways: to make it work in IE or to change source code. We selected second one.
The source code is about 11000 lines. Nice one :) jscripts\tiny_mce\tiny_mce.js It's interesting the part as from line 3537. The function with words "getContent" (please, notice there are more than one function with such words :) on this line we get a content for our editor:


h = this.doc.xml || new XMLSerializer().serializeToString(this.doc);

than delete some start and end HTML and PHP tags:


h = h.replace(/<\?[^?]+\?>|<html>|<\/html>|<html\/>|<!DOCTYPE[^>]+>/g, '');
   h = h.replace(/ ?\/>/g, ' />');
   if (this.valid) 
    h = h.replace(/\%MCGT%/g, '&gt;');

Interesting the function is called every time the content is place to the and from the text area. How to get when we have to replace img tag and when we have to replace back. Lets put some check like indexOf. So we'll get something like this:


getContent : function() { 
   var h;
 
   h = this.doc.xml || new XMLSerializer().serializeToString(this.doc);

   //ereg for test
   var istest = h.indexOf("test id=");
   if(istest >= 0) {
    h = h.replace(/<test[^>]*id=\"([0-9]*)\"[^>]*type=\"([^\"]*)\"[^>]*>/g, '<img test="$1" src="$2" />');
   }
   else {
    h = h.replace(/<img[^>]*test=\"([0-9]*)\"[^>]*src=\"([^\"]*)\"[^>]*>/g, '<test id="$1" type="$2" />');
   }

   h = h.replace(/<\?[^?]+\?>|html|<\/html>|<html\/>|<!DOCTYPE[^>]+>/g, '');
   h = h.replace(/ ?\/>/g, ' />');

   if (this.valid) 
    h = h.replace(/\%MCGT%/g, '&gt;');
  
   return h;
  }

That's all ))

Java Script mystery

2008-12-16T02:42:00.001-08:00

We can get a nice help on js programming language with just couple lines of code.
Well, lets try this one:


function addtext() { 
  var result = "";
  var x = window;
  for(n in x) {
   result += "window." + n + " \t\t= " + x[n] + "\n";
  }
  document.form.textarea.value = result;
 }
...
a href="javascript:addtext();
...

In IE we have a modest list of objects. It's very usefull if you'll forget any of that :) In IE 4.01 the list is shorter than in subsequent versions of IE.
So look on that code in FF browser. It's a great help there, like a book :) and in the Opera. We can see something like this:


window.i   = 4
window.addEventListener = function addEventListener() {
    [native code]
}
window.location  = http://www.arachnoid.com/javascript/interactiveJavaScript.html
window.navigator = [object Navigator]
window.n   = n
window.toNewPage = function toNewPage(t) {
    location.href = t.options[t.selectedIndex].value;
}
window.onload   = function onload(event) {
    jsInit();
}
window.onerror   = function jsHandleError(e, f, ln) {
    document.myForm.output.value = "JavaScript Error: " + e + " (" + ln + ")";
    return true;
}
window.window   = [object Window]
...

There is a website for testing simple scripts online: http://www.arachnoid.com/javascript/interactiveJavaScript.html

TinyMCE (create plugin)

2008-12-15T07:25:00.000-08:00

And create a plugin. We need a plugin for inserting images after select from the name list. So, go to folder jscripts\tiny_mce\plugins and create there your plugin folder with data like on the pic (just copy the data and folder structure from the similar plugin):

Then go to img folder and put there pic for the button (small pic). I've copied the data from the plugin with pop-up window. We have to alter some file dialog.htm:
(some tags were cleaned in order to pass the verification of this blog, still don't get clue how to put here html code :)


...
  a href="javascript:;" 
  onmousedown='tinyMCE.execCommand("mceInsertContent",false,"img src=\"code.jpg\" alt=\"test\"")'; 
  onclick='tinyMCEPopup.close();' >image1
...
  a href="javascript:;" 
  onmousedown='tinyMCE.execCommand("mceInsertContent",false,"img src=\"url.jpg\" alt=\"test\"")'; 
  onclick='tinyMCEPopup.close();' >image2
...

There is a list of links and after the click on the link the pop-up window closes and the image is inserted to the html area. Images are stored in the root folder. Also please don't forget to add to init code your new button. That's it :)

TinyMCE (alter plugin)

2008-12-15T07:24:00.001-08:00

Today we'll try to alter the existent plugin in order to suit it for our needs. Please, look on the plugin http://danielinsley.com/ created by Canadian programmer. This plugin has lines numeration and highlighted code presentation. Will add it to TinyMCE and replace old HTML button with new one (advcode).


tinyMCE.init({
...
theme_advanced_buttons2 : "cut,copy,...cleanup,help,advcode,|,insertdate,inserttime,preview,|,forecolor,backcolor",
...

We want the code to be altered while representation in HTML mode. For example we would like the [img] tag be replaced by test and then will be replaced back when we press Insert button.
Go to folder jscripts\tiny_mce\plugins\advcode\js and edit dialog.js file (lines in comments //edited were altered):


tinyMCEPopup.requireLangPack();
var CodeDialog = {
  init : function() {
    var f = document.forms[0];
    f.codepress.value = tinyMCEPopup.editor.getContent();
 //edited
 k = f.codepress.value;
 alert('DATA WILL BE CONVERTED FROM:\n\n' + k);
 var re = new RegExp('img(.*)?testdata="?([0-9]*)"?.*src="([^"]*)"[^>]*', 'gi');
 result = k.replace(re, '');
 //end edited

 f.codepress.value = result;
  },

  insert : function() {
    //tinyMCEPopup.editor.setContent(codepress.getCode());
 //edited
 k = codepress.getCode();
 var re = new RegExp('testdata id="([0-9]*)"(.*)?type="([^"]*)"[^>]*', 'gi');
 result = k.replace(re, '');
 alert('DATA WILL BE CONVERTED TO:\n\n' + result); 
 //end edited

 tinyMCEPopup.editor.setContent(result);
    tinyMCEPopup.close();
  }
};
tinyMCEPopup.onInit.add(CodeDialog.init, CodeDialog);

There is a good website for testing your regular expressions on Jscript: http://www.regular-expressions.info/javascriptexample.html

Interestin that many buttons in TinyMCE editor have very similar structure (they are plugins) and altering process is quick and usefull.

TinyMCE3 battle

2008-12-12T05:28:00.001-08:00

TineMCE is a platform-independent web-based JavaScript/HTML WYSIWYG editor control, released as open source software under the LGPL by Moxiecode Systems AB.
//wikipedia

Installing:
Getting work TinyMCE. It's really quick and simple :) Page where the TinyMCE editor will be place should contain following code.
Correct link to folder with js scripts:


script type="text/javascript" src="jscripts/tiny_mce/tiny_mce.js"

Some jscript for editor initialization. Sometimes people think this code should be in separate file. As in version 3 the code is in the page.
It strarts with something like this:


tinyMCE.init({...

And sure the text area should have id like this:


textarea id="elm1" ...

In js folder we have two interesting folders: langs and plugins.
Later in plugins folder we'll get our joy of creation :)

Plugin Image Manager 1.0:
There is a free plugin for TinyMCE editor for uploading and managing images. The name is not very secret, it's Image Manager 1.0
It's good, better say it's going to be good after some updatings. Everybody waits for it so well.
Cause the plugin works quite incorrect with Flash Player 10. And even with Flash Player 9 I had some mysterious times for what is the problem... So for now we'll just wait for updating and then try it again.
How to install it? Place folder images to modules\tinymce\tinymce\jscripts\tiny_mce\plugins
Create in root folder "storage" and give rights for writing/reading
Edit to code of the page with editor these lines:


plugins: …,images,…
theme_advanced_buttons1: …,images,…
relative_urls : false
remove_script_host : true

The button will appear in the first row. That's all.
Also some intersting info. In every plugin folder there are file like editor_plugin_src.js and editor_plugin.js
So first file is source file with tabs in code and comments. And the second one is only code in one line. The system takes last one.
I used to alter first file and then copy and rename it like the second one. Only when all is done I create correct second file with code in one line.

Add language:
Download language pack from the site (not just a xml file, you'll need it if would like to alter the language, add new words etc.) So I mistakenly tried to manage that xml file :) We just download language package for russian it's about 17Kb. And then copy info from the package to appropriate folders with same names. Choose option to rewrite files when you'll be asked about.
Also in code of the page with editor form point that language was changed with language: 'ru' line:


// General options
mode : "textareas",
language : 'ru',
theme : "advanced",

The editor is quite simple to manage. It's really nice one

.htaccess directives

2008-12-11T01:40:00.000-08:00

//tip list of .htaccess directives


=============================================================================#
          MAIN SETTINGS AND OPTIONS
=============================================================================#
 Options: ALL,FollowSymLinks,Includes,IncludesNOEXEC,SymLinksIfOwnerMatch
##########
 
## MAIN DEFAULTS ###
Options +ExecCGI -Indexes
DirectoryIndex index.html index.htm index.php
DefaultLanguage en-US
AddDefaultCharset UTF-8
ServerSignature Off
 
## ENVIRONMENT VARIABLES ###
SetEnv PHPRC /webroot/includes
SetEnv TZ America/Indianapolis
SetEnv SERVER_ADMIN webmaster@domain.tld
 
## MIME TYPES ###
AddType video/x-flv .flv
AddType application/x-shockwave-flash .swf
AddType image/x-icon .ico
 
## FORCE FILE TO DOWNLOAD INSTEAD OF APPEAR IN BROWSER ###
-> http://www.htaccesselite.com/addtype-addhandler-action-vf6.html
AddType application/octet-stream .mov .mp3 .zip
 
## ERRORDOCUMENTS ###
 
-> http://askapache.com/htaccess/apache-status-code-headers-errordocument.html
 
======== 1xx
ErrorDocument 100 /error-100/
ErrorDocument 101 /error-101/
ErrorDocument 102 /error-102/
======== 2xx
ErrorDocument 200 /error-200/
ErrorDocument 201 /error-201/
ErrorDocument 202 /error-202/
ErrorDocument 203 /error-203/
ErrorDocument 204 /error-204/
ErrorDocument 205 /error-205/
ErrorDocument 206 /error-206/
ErrorDocument 207 /error-207/
======== 4xx
ErrorDocument 400 /error-400/
ErrorDocument 401 /error-401/
ErrorDocument 402 /error-402/
ErrorDocument 403 /error-403/
ErrorDocument 404 /error-404/
ErrorDocument 405 /error-405/
ErrorDocument 406 /error-406/
ErrorDocument 407 /error-407/
ErrorDocument 408 /error-408/
ErrorDocument 409 /error-409/
ErrorDocument 410 /error-410/
ErrorDocument 411 /error-411/
ErrorDocument 412 /error-412/
ErrorDocument 413 /error-413/
ErrorDocument 414 /error-414/
ErrorDocument 415 /error-415/
ErrorDocument 416 /error-416/
ErrorDocument 417 /error-417/
ErrorDocument 418 /error-418/
ErrorDocument 419 /error-419/
ErrorDocument 420 /error-420/
ErrorDocument 421 /error-421/
ErrorDocument 422 /error-422/
ErrorDocument 423 /error-423/
ErrorDocument 424 /error-424/
ErrorDocument 425 /error-425/
ErrorDocument 426 /error-426/
======== 5xx
ErrorDocument 500 /error-500/
ErrorDocument 501 /error-501/
ErrorDocument 502 /error-502/
ErrorDocument 503 /error-503/
ErrorDocument 504 /error-504/
ErrorDocument 505 /error-505/
ErrorDocument 506 /error-506/
ErrorDocument 507 /error-507/
ErrorDocument 508 /error-508/
ErrorDocument 509 /error-509/
ErrorDocument 510 /error-510/
 
AddLanguage aa .aa # Afar
AddLanguage ab .ab # Abkhazian
AddLanguage af .af # Afrikaans
AddLanguage am .am # Amharic
AddLanguage ar .ar # Arabic
AddLanguage as .as # Assamese
AddLanguage ay .ay # Aymara
AddLanguage az .az # Azerbaijani
AddLanguage ba .ba # Bashkir
AddLanguage be .be # Byelorussian
AddLanguage bg .bg # Bulgarian
AddLanguage bh .bh # Bihari
AddLanguage bi .bi # Bislama
AddLanguage bn .bn # Bengali; Bangla
AddLanguage bo .bo # Tibetan
AddLanguage br .br # Breton
AddLanguage ca .ca # Catalan
AddLanguage co .co # Corsican
AddLanguage cs .cs # Czech
AddLanguage cy .cy # Welsh
AddLanguage da .da # Danish
AddLanguage de .de # German
AddLanguage dz .dz # Bhutani
AddLanguage el .el # Greek
AddLanguage en .en # English
AddLanguage eo .eo # Esperanto
AddLanguage es .es # Spanish
AddLanguage et .et # Estonian
AddLanguage eu .eu # Basque
AddLanguage fa .fa # Persian
AddLanguage fi .fi # Finnish
AddLanguage fj .fj # Fiji
AddLanguage fo .fo # Faeroese
AddLanguage fr .fr # French
AddLanguage fy .fy # Frisian
AddLanguage ga .ga # Irish
AddLanguage gd .gd # Scots Gaelic
AddLanguage gl .gl # Galician
AddLanguage gn .gn # Guamni
AddLanguage gu .gu # Gujarati
AddLanguage ha .ha # Hausa
AddLanguage he .he # Hebrew
AddLanguage hi .hi # Hindi
AddLanguage hr .hr # Croatian
AddLanguage hu .hu # Hungarian
AddLanguage hy .hy # Armenian
AddLanguage ia .ia # Interlingua
AddLanguage id .id # Indonesian
AddLanguage ie .ie # lnteriingue
AddLanguage ik .ik # Knupiak
AddLanguage is .is # Icelandic
AddLanguage it .it # Italian
AddLanguage iu .iu # Inuktitut (Eskimo)
AddLanguage ja .ja # Japanese
AddLanguage jw .jw # Javanese
AddLanguage ka .ka # Georgian
AddLanguage kk .kk # Kazakh
AddLanguage kl .kl # Greaenlandic
AddLanguage km .km # Cambodian
AddLanguage kn .kn # Kannada
AddLanguage ko .ko # Korean
AddLanguage ks .ks # Kashmiri
AddLanguage ku .ku # Kurdish
AddLanguage ky .ky # Kirghiz
AddLanguage la .la # Latin
AddLanguage ln .ln # Lingala
AddLanguage lo .lo # Laothian
AddLanguage lt .lt # Lithuainnian
AddLanguage lv .lv # Latvian, Lettish
AddLanguage mg .mg # Malagasy
AddLanguage mi .mi # Maori
AddLanguage mk .mk # Macedonian
AddLanguage ml .ml # Malayalam
AddLanguage mn .mn # Mongolian
AddLanguage mo .mo # Moldavian
AddLanguage mr .mr # Marathi
AddLanguage ms .ms # Malay
AddLanguage mt .mt # Maltese
AddLanguage my .my # Burmese
AddLanguage na .na # Nauru
AddLanguage ne .ne # Nepali
AddLanguage nl .nl # Dutch
AddLanguage no .no # Norwegian
AddLanguage oc .oc # Occitan
AddLanguage om .om # (Afan) Oromo
AddLanguage or .or # Oriya
AddLanguage pa .pa # Punjabi
AddLanguage pl .po # Polish (use .po instead .pl to avoid problems with perl files)
AddLanguage ps .ps # Pashto, Pushto
AddLanguage pt .pt # Portuguese
AddLanguage qu .qu # Ouechua
AddLanguage rm .rm # Rhaeto-Romance
AddLanguage rn .rn # Kirundi
AddLanguage ro .ro # Romanian
AddLanguage ru .ru # Russian
AddLanguage rw .rw # Kinya, Rwanda
AddLanguage sa .sa # Sanskrit
AddLanguage sd .sd # Sindhi
AddLanguage sg .sg # Sangro
AddLanguage sh .sh # Serbo-Croatian
AddLanguage si .si # Singhalese
AddLanguage sk .sk # Slovak
AddLanguage sl .sl # Slovenian
AddLanguage sm .sm # Samoan
AddLanguage sn .sn # Shona
AddLanguage so .so # Somali
AddLanguage sq .sq # Albanian
AddLanguage sr .sr # Serbian
AddLanguage ss .ss # Siswati
AddLanguage st .st # Sesotho
AddLanguage su .su # Sundanese
AddLanguage sv .sv # Swedish
AddLanguage sw .sw # Swahili
AddLanguage ta .ta # Tamil
AddLanguage te .te # Tegulu
AddLanguage tg .tg # Tajik
AddLanguage th .th # Thai
AddLanguage ti .ti # Tigrinya
AddLanguage tk .tk # Turkmen
AddLanguage tl .tl # Tagalog
AddLanguage tn .tn # Setswana
AddLanguage to .to # Tonga
AddLanguage tr .tr # Turkish
AddLanguage ts .ts # Tsonga
AddLanguage tt .tt # Tatar
AddLanguage tw .tw # Twi
AddLanguage ug .ug # Uigur
AddLanguage uk .uk # Ukrainian
AddLanguage ur .ur # Urdu
AddLanguage uz .uz # Uzbek
AddLanguage vi .vi # Vietnamese
AddLanguage vo .vo # Volapuek
AddLanguage wo .wo # Wolof
AddLanguage xh .xh # Xhosa
AddLanguage yi .yi # Yiddish
AddLanguage yo .yo # Yoruba
AddLanguage za .za # Zhuang
AddLanguage zh .zh # Chinese
AddLanguage zu .zu # Zulu
 
=============================================================================#
          SCRIPTING, ACTION, ADDHANDLER
=============================================================================#
 Handlers be builtin, included in a module, or added with Action directive
 default-handler: default, handles static content (core)
      send-as-is: Send file with HTTP headers (mod_asis)
      cgi-script: treat file as CGI script (mod_cgi)
       imap-file: Parse as an imagemap rule file (mod_imap)
     server-info: Get server config info (mod_info)
   server-status: Get server status report (mod_status)
        type-map: type map file for content negotiation (mod_negotiation)
  fastcgi-script: treat file as fastcgi script (mod_fastcgi)
##########
 
-> http://www.askapache.com/php/custom-phpini-tips-and-tricks.html
 
## PARSE AS CGI ###
AddHandler cgi-script .cgi .pl .spl
 
## RUN PHP AS APACHE MODULE ###
AddHandler application/x-httpd-php .php .htm
 
## RUN PHP AS CGI ###
AddHandler php-cgi .php .htm
 
## CGI PHP WRAPPER FOR CUSTOM PHP.INI ###
AddHandler phpini-cgi .php .htm
Action phpini-cgi /cgi-bin/php5-custom-ini.cgi
 
## FAST-CGI SETUP WITH PHP-CGI WRAPPER FOR CUSTOM PHP.INI ###
AddHandler fastcgi-script .fcgi
AddHandler php-cgi .php .htm
Action php-cgi /cgi-bin/php5-wrapper.fcgi
 
## CUSTOM PHP CGI BINARY SETUP ###
AddHandler php-cgi .php .htm
Action php-cgi /cgi-bin/php.cgi
 
## PROCESS SPECIFIC FILETYPES WITH CGI-SCRIPT ###
Action image/gif /cgi-bin/img-create.cgi
 
## CREATE CUSTOM HANDLER FOR SPECIFIC FILE EXTENSIONS ###
AddHandler custom-processor .ssp
Action custom-processor /cgi-bin/myprocessor.cgi
 
=============================================================================#
          HEADERS, CACHING AND OPTIMIZATION
=============================================================================#
-> http://www.htaccesselite.com/cache-control-http-headers-vt65.html
      300   5 M
     2700  45 M
     3600   1 H
    54000  15 H
    86400   1 D
   518400   6 D
   604800   1 W
  1814400   3 W
  2419200   1 M
 26611200  11 M
 29030400   1 Y (never expire)
##########
 
### HEADER CACHING ####
-> http://www.askapache.com/htaccess/speed-up-sites-with-htaccess-caching.html

   Header set Cache-Control "max-age=2592000"


   Header set Cache-Control "max-age=604800"


   Header set Cache-Control "max-age=600"


   Header unset Cache-Control

 
## ALTERNATE EXPIRES CACHING ###
-> htaccesselite.com/d/use-htaccess-to-speed-up-your-site-discussion-vt67.html
ExpiresActive On
ExpiresDefault A604800
ExpiresByType image/x-icon A2592000
ExpiresByType application/x-javascript A2592000
ExpiresByType text/css A2592000
ExpiresByType text/html A300

   ExpiresActive Off

 
## META HTTP-EQUIV REPLACEMENTS ###

   Header set imagetoolbar "no"

 
=============================================================================#
          REWRITES AND REDIRECTS
=============================================================================#
 REQUEST METHODS: GET,POST,PUT,DELETE,CONNECT,OPTIONS,PATCH,PROPFIND,
                  PROPPATCH,MKCOL,COPY,MOVE,LOCK,UNLOCK
##########
 
## REWRITE DEFAULTS ###
RewriteEngine On
RewriteBase /
 
## REQUIRE SUBDOMAIN ###
RewriteCond %{HTTP_HOST} !^$
RewriteCond %{HTTP_HOST} !^subdomain\.domain\.tld$ [NC]
RewriteRule ^/(.*)$ http://subdomain.domain.tld/$1 [L,R=301]
 
## SEO REWRITES ###
RewriteRule ^(.*)/ve/(.*)$    $1/voluntary-employee/$2 [L,R=301]
RewriteRule ^(.*)/hsa/(.*)$     $1/health-saving-account/$2 [L,R=301]
 
## WORDPRESS ###
RewriteCond %{REQUEST_FILENAME} !-f    # Existing File
RewriteCond %{REQUEST_FILENAME} !-d    # Existing Directory
RewriteRule . /index.php [L]
 
## ALTERNATIVE ANTI-HOTLINKING ###
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^http://(subdomain\.)?domain.tld/.*$ [NC]
RewriteRule ^.*\.(bmp|tif|gif|jpg|jpeg|jpe|png)$ - [F]
 
## REDIRECT HOTLINKERS ###
RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^http://(subdomain\.)?domain.tld/.*$ [NC]
RewriteRule ^.*\.(bmp|tif|gif|jpg|jpeg|jpe|png)$ http://google.com [R]
 
## DENY REQUEST BASED ON REQUEST METHOD ###
RewriteCond %{REQUEST_METHOD} ^(TRACE|TRACK|OPTIONS|HEAD)$ [NC]
RewriteRule ^.*$ - [F]
 
## REDIRECT UPLOADS ###
RewriteCond %{REQUEST_METHOD} ^(PUT|POST)$ [NC]
RewriteRule ^(.*)$ /cgi-bin/form-upload-processor.cgi?p=$1 [L,QSA]
 
## REQUIRE SSL EVEN WHEN MOD_SSL IS NOT LOADED ###
RewriteCond %{HTTPS} !=on [NC]
RewriteRule ^.*$ https://%{SERVER_NAME}%{REQUEST_URI} [R,L]
 
### ALTERNATATIVE TO USING ERRORDOCUMENT ###
-> http://www.htaccesselite.com/d/htaccess-errordocument-examples-vt11.html
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^.*$ /error.php [L]
 
## SEO REDIRECTS ###
Redirect 301 /2006/oldfile.html http://subdomain.domain.tld/newfile.html
RedirectMatch 301 /o/(.*)$ http://subdomain.domain.tld/s/dl/$1
 
=============================================================================#
          AUTHENTICATION AND SECURITY
=============================================================================#
 http://www.htaccesselite.com/basic-authentication-example-vt17.html
 
 Require (user|group|valid-user) (username|groupname)
##########
 
## BASIC PASSWORD PROTECTION ###
AuthType basic
AuthName "prompt"
AuthUserFile /.htpasswd
AuthGroupFile /dev/null
Require valid-user
 
## ALLOW FROM IP OR VALID PASSWORD ###
Require valid-user
Allow from 192.168.1.23
Satisfy Any
 
## PROTECT FILES ###

  Order Allow,Deny
  Deny from all

 
## PREVENT HOTLINKING ###
SetEnvIfNoCase Referer "^http://subdomain.domain.tld/" good
SetEnvIfNoCase Referer "^$" good

   Order Deny,Allow
   Deny from all
   Allow from env=good
   ErrorDocument 403 http://www.google.com/intl/en_ALL/images/logo.gif
   ErrorDocument 403 /images/you_bad_hotlinker.gif

 
## LIMIT UPLOAD FILE SIZE TO PROTECT AGAINST DOS ATTACK ###
LimitRequestBody 10240000 #bytes, 0-2147483647(2GB)
 
=============================================================================#
          SSL SECURITY
=============================================================================#
-> http://www.askapache.com/htaccess/ssl-example-usage-in-htaccess.html
##########
 
## MOST SECURE WAY TO REQUIRE SSL ###
-> http://www.askapache.com/htaccess/apache-ssl-in-htaccess-examples.html
SSLOptions +StrictRequire
SSLRequireSSL
SSLRequire %{HTTP_HOST} eq "domain.tld"
ErrorDocument 403 https://domain.tld
 
=============================================================================#
          SITE UNDER CONSTRUCTION
=============================================================================#
 Heres some awesome htaccess to use when you are developing a site
##########
 
## COMBINED DEVELOPER HTACCESS CODE-USE THIS ###

   Header set Cache-Control "max-age=5"

AuthType basic
AuthName "Ooops! Temporarily Under Construction..."
AuthUserFile /.htpasswd
AuthGroupFile /dev/null
Require valid-user           # password prompt for everyone else
Order Deny,Allow
Deny from all
Allow from 192.168.64.5      # Your, the developers IP address
Allow from w3.org            # css/xhtml check jigsaw.w3.org/css-validator/
Allow from googlebot.com     # Allows google to crawl your pages
Satisfy Any                  # no password required if host/ip is Allowed
 
## DONT HAVE TO EMPTY CACHE OR RELOAD TO SEE CHANGES ###
ExpiresDefault A5 #If using mod_expires

   Header set Cache-Control "max-age=5"

 
## ALLOW ACCESS WITH PASSWORD OR NO PASSWORD FOR SPECIFIC IP/HOSTS ###
AuthType basic
AuthName "Ooops! Temporarily Under Construction..."
AuthUserFile /.htpasswd
AuthGroupFile /dev/null
Require valid-user           # password prompt for everyone else
Order Deny,Allow
Deny from all
Allow from 192.168.64.5      # Your, the developers IP address
Allow from w3.org            # css/xhtml check jigsaw.w3.org/css-validator/
Allow from googlebot.com     # Allows google to crawl your pages
Satisfy Any                  # no password required if host/ip is Allowed

MySQL (foreign key)

2008-12-10T08:27:00.000-08:00

Foreign keys are used to keep integrity data if it exists in different tables.
For example, we have books and authors tables:


CREATE TABLE /*!32312 IF NOT EXISTS*/ "authors" (
  "id" int(10) unsigned NOT NULL auto_increment,
  "book_id" int(10) unsigned default NULL,
  "name" varchar(50) default NULL,
  KEY "id" ("id")
) /*!40100 DEFAULT CHARSET=utf8*/;

CREATE TABLE /*!32312 IF NOT EXISTS*/ "books" (
  "id" int(10) unsigned NOT NULL auto_increment,
  "name" varchar(50) default NULL,
  KEY "id" ("id")
) /*!40100 DEFAULT CHARSET=utf8*/;

We want to prevent inserting / updating records in books table if there is no proper record in authors table. Actually, why we need to create book with author_id that is absent in authors table? MySQL can keep checking that itself. Let's try.
Create foreign key:


alter table books add foreign key(author_id) references authors(id)

Now we have foreign key author_id in books table.
We can turn on/off foreign key checking by MySQL engine with command like


SET foreign_key_checks = 0;
SET foreign_key_checks = 1;

This command will be active to the end of the current MySQL session.
Also we can use the commang like:


ALTER TABLE books WITH NOCHECK add foreign key(author_id) references authors(id)

This is an example of turning off checking while only the current query.

We can control child tables while updating / altering data in parent table using ON UPDATE and ON DELETE. Also we can use 5 expressions with on update and on delete:
CASCADE: related records in child tables will be updated if parent record was altered.
SET NULL: related records in child tables will be set to NULL value in parent record was altered.
NO ACTION, RESTRICT: prohibit altering / deleting records from parent table with values that present in child table. We'll get an error like "Foreign key constraint..."
SET DEFAULT: the command is recognized by parser but InnoDB engine doesn't react to it.

Note: if we want to add ON UPDATE / ON DELETE expression to our foreign key, we run the command again with this expressions:


ALTER TABLE books add foreign key(author_id) references authors(id) on update cascade

Now let's test how it works:
Will add record to books table with authors_id that is absent in authors table:


SQL-запрос: Изменить

INSERT INTO `fkey`.`books` (
`id` ,
`author_id` ,
`name`
)
VALUES (
NULL , '1', 'Oleg'
)

Ответ MySQL: Документация
#1216 - Cannot add or update a child row: a foreign key constraint fails

It's right. Now create author in authors table:


INSERT INTO `fkey`.`authors` (
`id` ,
`name`
)
VALUES (
'1', 'Author Valentin'
);

And rerun the query:


INSERT INTO `fkey`.`books` (
`id` ,
`author_id` ,
`name`
)
VALUES (
NULL , '1', 'Oleg'
);

It was allowed. MySQL is clever, isn't it :)

PHP5 (base connect)

2008-12-10T07:48:00.000-08:00

//some class for database interaction

It's usefull to have a class for interaction with database. We can ofter use it in our projects. It's simple and handy :)

Will create two inc files: db_connect.inc


class DB_Mysql {
 protected $user;
 protected $pass;
 protected $dbhost;
 protected $dbname;
 protected $dbh; // Database connection handle
 public function __construct($user, $pass, $dbhost, $dbname) {
  $this->user = $user;
  $this->pass = $pass;
  $this->dbhost = $dbhost;
  $this->dbname = $dbname;
 }
 protected function connect() {
  $this->dbh = mysql_pconnect($this->dbhost, $this->user, $this->pass);
  if(!is_resource($this->dbh)) {
   throw new Exception;
  }
  if(!mysql_select_db($this->dbname, $this->dbh)) {
   throw new Exception;
  }
 }
 public function execute($query) {
  if(!$this->dbh) {
   $this->connect();
  }
  $ret = mysql_query($query, $this->dbh);
  if(!$ret) {
   //throw new Exception;
  }
  else if(!is_resource($ret)) {
   return TRUE;
  }
  else {
   $stmt = new DB_MysqlStatement($this->dbh, $query);
   $stmt->result = $ret;
   return $stmt;
  }
 }
}

and file db_statement.inc


class DB_MysqlStatement {
 public $result;
 public $query;
 protected $dbh;
 public function __construct($dbh, $query) {
  $this->query = $query;
  $this->dbh = $dbh;
  if(!is_resource($dbh)) {
   throw new Exception("Not a valid database connection");
  }
 }
 public function fetch_row() {
  if(!$this->result) {
   throw new Exception("Query not executed");
  }
  return mysql_fetch_row($this->result);
 }
 public function fetch_assoc() {
  return mysql_fetch_assoc($this->result);
 }
 public function fetchall_assoc() {
  $retval = array();
  while($row = $this->fetch_assoc()) {
   $retval[] = $row;
  }
  return $retval;
 }
}

And that's cool. Now we can use it:


include("db_connect.php");
include("db_statement.php");

$dbh = new DB_Mysql("root", "admin", "localhost", "base");
$query = "SELECT * FROM `users` ";
$stmt = $dbh->execute($query);
while ($row = $stmt->fetch_assoc()) {
 print_r($row);
}

very nice ))

CakePHP (lang/url)

2008-12-09T11:51:00.000-08:00

Yes, we want to have the language in url. Let's make use of Cake url:
http://hostname/controller/action/param1/param2/...

Well, can we create a controller like "en" or "ru"? It's a deal.
Create two controllers: "en_controller.php", "ru_controller.php" with content like this (for en_controller.php):


include_once("site_controller.php");
class EnController extends SiteController {
var $lang = "en";
}

And in site_controller we add the function:


function beforeRender() {
$lang = $this->lang;
$this->set('lang', $lang);
if ($this->Session->read('Config.language') != $lang) {
$this->Session->write('Config.language', $lang);
}
}

Go to file app/config/routes.php and add line:


Router::connect('/', array('controller' => 'ru', 'action' => 'index'));

Folders app/locale/eng and app/locale/rus - are like in the previous post.
So, navigating address like: http://hostname/en/books/2 we'll activate en_controller.php. In this controller the variable $lang will be declared and used in site_controller.php in function beforeRender(). The proper session variable will be created.

P.S. also we need links for switching between languages, the link address in view will be something like:


/lang/ru

So, if click it - site_controller will be activated, function lang in this case. Value "en" will be written to the session variable and than should redirect back to the referrer. As a aresult while rendering view new session variable will be read (function beforeRender) and proper language phrases will be placed to the view. It works :)

CakePHP (lang)

2008-12-08T12:59:00.000-08:00

//With session vars and cookies

Today we go to app/locale/. There are one folder like "eng". We want to add second language "rus".
Ok, create second folder "rus". Than go to Eng folder and copy folder LC_MESSAGES with language file to our new folder Rus. Finally we have two folders Eng and Rus in app/locale/ and there are folder LC_MESSAGES and language file in both.
The language file for eng language is something like this: "default.po" and it's content:


msgid "start_page"
msgstr "Start page (english language)"

msgid "catalog"
msgstr "Catalog"

msgid "some_books"
msgstr "Books with id <>change($lang);

...

Now we create p28n_controller.php:


class P28nController extends AppController {
   var $name = 'P28n';
   var $uses = null;
   var $components = array('P28n');

   function change($lang = null) {
       $this->P28n->change($lang);

       $this->redirect($this->referer(null, true));
   }

   function shuntRequest() {
       $this->P28n->change($this->params['lang']);

       $args = func_get_args();
       $this->redirect("/" . implode("/", $args));
   }
}

and than create a component "app/controllers/components/p28n.php":


class P28nComponent extends Object {
    var $components = array('Session', 'Cookie');

    function startup() {
        if (!$this->Session->check('Config.language')) {
            $this->change(($this->Cookie->read('lang') ? $this->Cookie->read('lang') : 'en-us'));
        }
    }

    function change($lang = null) {
        if (!empty($lang)) {
            $this->Session->write('Config.language', $lang);
            $this->Cookie->write('lang', $lang, null, '+350 days');
        }
    }
}

OK. In our controller declare the variable like our component:


var $components = array('P28n');

Now we can use it in our controller like:


$this->pageTitle = __('pageTitle_home', true);

Note, that if second parameter is true - the message will be returned as a value (use it in controller)
And if false - the message will be echo'd (use it this way in a template)


__('pageTitle_home');

And that's all. It's sad that we don't have the language prefix in url. Will do more in the next post :)

Python, Zope, Plone

2008-12-06T05:28:00.000-08:00

Today we'll try some Python, Zope and Plone.
Python supports several programming styles. Object oriented and structured programming. There is dynamic typing and a cycle detecting garbage collector for memory management. Python supports dynamic name resolution, large standard library.
Download installation package from python.org site, it's about 13Mb. Installation process is simple enough. Now we have in programs menu shortcuts for GUI and command line consoles. Start it. There is >>> sign at the begin of the line (can be altered on any other sign). The interpreter is waiting for your commands.

Zope - object-oriented web server in the Python programming language. Is free and open-source. Download installation package from zope.org website and install it. On default the port 127.0.0.1 localhost will be used. Open web browser and navigate to that address. Nothing seems to work. To make it create DTML method in index file of the web folder (there is description how to create that method on zope official website). DTML - it's something like Smarty. OK, navigate to http://localhost again, no result. For now just type http://localhost/index.html or something like that to test if your DTML method works well. Cause there is no automatic redirecting to index file just after installation.

Plone - open source CMS for internal sites built on the Zope server. All information stored in Plone is stored in Zope built-in transaction object database (ZODB). There are templates writing with CSS for customizing a website look. OK, download installation package from plone.org website. It's about 24Mb. After installation it we can see that python language and zope framework were installed with it. In programs menu we can see Plone shortcut. Start it. The small window appears. It's something like IIS for management. Press button "Start Plone" and navigate to localhost address. After login we can create manage the cms, create items (types: text, file, folder etc.), set rules for navigating and redirecting. Also don't forget about workflow system, so the item after creating won't be visible on frontend if not approved yet. As for me, it's accurate and handy cms :)

CMS (about)

2008-12-05T13:51:00.000-08:00

And now cms. It's great deal for huge companies and even for small portals. The idea - to automatize most primitive work and fix on management and representation of the content. Also to divide security rights and stages of publishing new materials. One deal - to alter content. The other - to make it presentation flow simple and clear.

Case one. We have very complicated cms. It consists of every probable needed module / functionality. After in-depth study we get universal remedy for our needs. Yes, sometimes support team of that cms is only one way option to implement the needs.

Case two. We have simple cms. It's not waste time to learn but this tool cannot implement every your idea. Just for simple portal / website. And yes, it's not perspective because of it's simplicity.

Case three. We have open source cms with modular architecture. So, the time for learning depends of our plans and it's so easy to enlarge such cms.

Some words about Bitrix (1c-bitrix.ru). It's a cms for websites and e-stores. It's not open source, you can be suprised a little that some system files are enciphered :) yes just have tried to find some text in source files and without any success )) it was funny. Declared functionality is wide enought. Especially for e-stores - we already have all components for that. Just put it on the page and that's it. But, if we want to change the declared functionality - we have some interesting time. In some cases it's hard to get clue what was done on this or that stage. We cannot look into the code, maybe it's like a game in a black box :) Great help we can get on the forum, that's a deal.

Also for simple websited we have something like admin-part. Very ofter it's the same code just with some addition in functionality. Usual functionality - rich text pages, different files, images, video, etc. In logic we have division into users with different rights for altering the content. Also sending emails, getting information from the site's forms. No any workflow system, weak security protection. That's enough for simple websites.

CakePHP (install)

2008-12-05T13:43:00.001-08:00

CakePHP is an open source web application framework for producing web applications written in PHP. It is written in PHP, is modeled after the concepts of Ruby on Rails, and is distributed under the MIT License.
//wikipedia

Yes, it's easy and effective enough for websites that are thought not to be very overladen. It's not the best variant for chat, multimedia portal, etc.
We can download the package from the site cakephp.org and try to install it. It's a quick deal.

Folder "app" - it's a folder for our site. Other folders: cake, docs, vendors - are system for the framework. And we go... Copy all that that folders and files in the root directory of your host.

Go to app/config/core.php
For the first time set Configure::write('debug', 2); //it's a level of error / notice reporting
Best variant to use utf-8: Configure::write('App.encoding', 'UTF-8');
Your can be asked to set random string used in security hashing methods: Configure::write('Security.salt', 'justyourandomsymbolshere');

Go to app/config/routes.php
Later you would like to change redirecting rules on you website.

Copy app/config/database.php.default file to database.php
Usually I set there something like this:


var $default = array(
    'driver' => 'mysql',
    'persistent' => false,
    'host' => 'localhost',
    'login' => 'sasha',
    'password' => 'magicduck',
    'database' => 'test_base',
    'prefix' => 'tt_',
    'encoding' => 'utf8'
);

prefix - if you're planning to add forum with many other tables to the website it's good way to add prefix to your cakephp tables.
encoding - just set encoding for your pages. utf8 works fine and you'll shouldn't get stange symbols any more.

Now folder "controllers" - there will be your controllers files.
Folder "models" - your models files. Good idea to name model files in singular mode.
Folder "views" - views for your pages. There is folder "elements" - elements for pages, folder "layouts" - layouts for your site.
Folder "webroot" - folder "files" there will be files for your site content: images, sounds, movies, etc. Also "css" - styles and "js" - scripts folders are there.
Folder "locale" - can be used for multilanguage for your site.

And please, don't forget use Ctrl+F5 while reloading the page and also to clear "\tmp\cache\models" folder after altering models files. Happy baking :)

http://cakephp.org