Code.ge Blog » GeoKBD http://www.code.ge ბლოგი ვებ პროგრამირებისა და ტექნოლოგიების შესახებ Mon, 03 May 2010 14:38:57 +0000 en hourly 1 http://wordpress.org/?v=3.0 GeoKBD & WordPress http://www.code.ge/posts/geokbd-wordpress http://www.code.ge/posts/geokbd-wordpress#comments Sat, 15 Dec 2007 14:07:37 +0000 იოსები http://www.code.ge/geokbd/geokbd-wordpress რამდენიმე ადამიანის თხოვნით ჩავატარე გარკვეული ტესტირებები GeoKBD – ს WordPress – თან ინტეგრაციაზე… მიუხედავად იმისა რომ WP იყენებს TinyMCE – ს ტექსტების ვიზუალური რედაქტირებისათვის აღმოჩნდა რომ GeoKBD – ს ინტეგრირება მაინც ვერ მოხერხდა.

მიზეზი მარტივი აღმოჩნდა ძალიან, WordPress – ის დეველოპერებს გადაუტვირთიათ გლობალური TinyMCE კლასის მეთოდები რის გამოც პლაგინის ჩატვირთვა ისე აღარ ხდება როგორც ეს ჩვეულებრივ TinyMCE – ს დოკუმენტაციაშია მითითებული.

ამისათვის გავაკეთე პლაგინის განახლება, რომელიც განთავსებულია გუგლის რეპოზიტორიში და შეგიძლიათ გადმოიწეროთ.

რაც შეეხება ინსტალაციას. ეს პროცესი ტრადიციულად მარტივია, გახსენით geokbd-0-2.zip და მის შიგნით არსებული ფაილები გადაიტანეტ ქვემოთ ნაჩვენებ კატალოგში:

/[ROOT]/wp-includes/js/tinymce/plugins/geokbd

ცხადია geokbd კატალოგი წინასწარ უნდა შექმნათ.

შემდეგ გახსენით ფაილი:

/[ROOT]/wp-includes/js/tinymce/tiny_mce_config.php

და მასში მოძებნეთ შემდეგი სტრიქონი: 

$plugins = array('inlinepopups', 'autosave', 'spellchecker', 'paste', 'wordpress');

ეს სტრიქონი დაახლოვებით 28-ე ხაზზეა. შემდეგ გადააკეთეთ იგი შემდეგნაირად:

$plugins = array('inlinepopups', 'autosave', 'spellchecker', 'paste', 'wordpress', 'geokbd');

ანუ პლაგინების ჩამონათვალის მასივში საჭიროა geokbd პლაგინის სახელის მითითება.

სულ ეს არის და ეს :)

]]> http://www.code.ge/posts/geokbd-wordpress/feed 34 GeoKBD 0.3.1 – მორიგი გაუმჯობესებები http://www.code.ge/posts/geokbd-031-various-improvements http://www.code.ge/posts/geokbd-031-various-improvements#comments Mon, 26 Nov 2007 09:59:15 +0000 იოსები http://www.code.ge/geokbd/geokbd-031-various-improvements პირველ რიგში დიდი მადლობა სკრიპტის მომხმარებლებს აღმოჩენილი პრობლემებისა და გაუმჯობესებების შემოთავაზებისათვის!

ეს მცირე განახლება მოიცავს შემდეგ გაუმჯობესებებს:

დაიხვეწა GeoKBD.map() მეთოდის გამოყენების მექანიზმი და აგრეთვე გაფართოვდა მისი შესაძლებლობი.

  • ამ მეთოდის გამოყენება შეიძლება უპარამეტროდ, კერძოდ კი თუ მას არ გადავცემთ არცერთ პარამეტრს, კლავიატურის მიბმა მოხდება დოკუმენტში არსებული ყველა ფორმის ყველა ტექსტურ ველზე. ამის მისაღწევად საკმარისია შემდეგი კონსტრუქცია: 
        GeoKBD.map();
  • მეთოდს პირველ პარამეტრად შეგვიძლია გადავცეთ არა უბრალოდ ფორმის სახელი სტრიქონის მეშვეობით, არამედ ფორმის დასახელებების მასივი: 
        GeoKBD.map(['my_form_1', 'my_form_2']);

    ეს შესაძლებლობა თავიდან აგვარიდებს დამატებითი კოდის წერის აუცილებლობას, რადგან ზემოთ ნაჩვენები შედეგის მისაღწევად აქამდე საჭირო იყო მსგავსი კონსტრუქციის გამოყენება:

        GeoKBD.map('my_form_1');
    GeoKBD.map('my_form_2');
  • დაიფიქსა შეცდომა როდესაც პარამეტრად გადაცემული ფორმის არ არსებობის შემთხვევაში სკრიპტი აგდებდა შეცდომებს;
  • დაიფიქსა WYSIWYG რედაქტორებზე მიბმის დროს აღმოჩენილი შეცდომა Alt და Ctrl კლავიშებთან დაკავშირებით. ამჯერად ეს კლავიშები მუშაობს;

ამ შეცდომების აღმოჩენისათვის განასკუთრებულ მადლობას ვუხდი Rocko – ს და ლევანჩოს :)

]]> http://www.code.ge/posts/geokbd-031-various-improvements/feed 42 GeoKBD – TinyMCE Dedicated Plugin 0.1 http://www.code.ge/posts/geokbd-tinymce-dedicated-plugin-01 http://www.code.ge/posts/geokbd-tinymce-dedicated-plugin-01#comments Tue, 20 Nov 2007 09:24:58 +0000 იოსები http://www.code.ge/geokbd/geokbd-tinymce-dedicated-plugin-01 tinymce.gif მაშ ასე, ვაგრძელებ GeoKBD – სთან თამაშს :) ამჯერად შევქმენი ცნობილი WYSIWYG რედაქტორის TinyMCE – ს პლაგინი. მართალია GeoKBD – ს მასზე მიბმა არ წარმოადგენს არც პლაგინის გარეშე პრობლემას, მაგრამ როგორც ჩანს პლაგინის არსებობა გარკვეულწილად უფრო კომფორტულს ხდის ამ სკრიპტის მოხმარებადობას.

პლაგინის დაარქივებული ვერსიის გადმოწერა შესაძლებელია SVN რეპოზიტორიდან.

რაც შეეხება ინსტალაციას…

გახსენით არქივი და geokbd დირექტორია გადააკოპირეთ plugins დირექტორიში, თქვენი TinyMCE – ს ინსტალაციის შესაბამის მისამართზე. მაგ:

/public_html/tinymce/jscripts/tiny_mce/plugins

შემდეგ, იმ HTML დოკუმენტში/შაბლონში სადაც ხორციელდება უშუალოდ TinyMCE რედაქტორის ინიციალიზაცია, იპოვეთ მსგავსი მონაკვეთი:

tinyMCE.init({
    theme : "advanced",
    mode : "exact",
    elements : "elm1,elm2",
    save_callback : "customSave",
    content_css : "example_advanced.css",
    extended_valid_elements : "a[href|target|name]",

    plugins : "table", //პლაგინების ჩამონათვალი

    theme_advanced_buttons3_add_before : "tablecontrols,separator",
    //execcommand_callback : "myCustomExecCommandHandler",
    debug : false
});

და ინიციალიზაციის ობიექტის plugins თვისების მნიშვნელობას დაამატეთ პლაგინის სახელი: geokbd.

საბოლოო ჯამში ინიციალიზაციის ობიექტი მიიღებს ასეთ სახეს:

tinyMCE.init({
    theme : "advanced",
    mode : "exact",
    elements : "elm1,elm2",
    save_callback : "customSave",
    content_css : "example_advanced.css",
    extended_valid_elements : "a[href|target|name]",

    plugins : "geokbd,table", //geokbd პლაგინის მითითება

    theme_advanced_buttons3_add_before : "tablecontrols,separator",
    //execcommand_callback : "myCustomExecCommandHandler",
    debug : false
});

სულ ეს არის… TinyMCE – ში უკვე შესაძლებელია ქართულად წერა. ქართული კლავიატურის ჩართვა გამორთვისათვის გამოიყენეთ “~” კლავიში.

]]> http://www.code.ge/posts/geokbd-tinymce-dedicated-plugin-01/feed 50 GeoKBD 0.3 – Rich Editor Support Completed! http://www.code.ge/posts/geokbd-03-rich-editor-support-completed http://www.code.ge/posts/geokbd-03-rich-editor-support-completed#comments Mon, 19 Nov 2007 08:05:00 +0000 იოსები http://www.code.ge/geokbd/geokbd-30-rich-editor-support-finished ამჯერად WYSIWYG რედაქტორების მხარდაჭერა რეალიზებულია IE6/7 – ისათვის, შედარებით მახინჯი გამოსავალის მოძებნა გახდა ამისათვის საჭირო, თუმცა ეს არ არის ამ ეტაპზე მთავარი. ამიერიდან GeoKBD – ს ინტეგრაცია თავისუფლად შესაძლებელია WYSIWYG ტიპის რედაქტორებთან. მაგალითები შეგიძლიათ იხილოთ ამ გვერდზე.

ასევე ამ რელიზში შესულია კიდევ ერთი გაუმჯობესება, ქართული კლავიატურის ჩართვა გამორთვისათვის უბრალოდ საკმარისია “~” ღილაკის გამოყენება, ე.წ. checkbox ელემენტი საჭირო აღარ არის, თუმცა მისი გამოყენება კვლავ შეიძლება და სკრიპტს მუშაობაში ხელს არ უშლის.

განახლებული ვერსიის გადმოწერა შეგიძლია SVN – იდან

]]> http://www.code.ge/posts/geokbd-03-rich-editor-support-completed/feed 7 GeoKBD 0.2.2 – Rich Editor Support Improvements http://www.code.ge/posts/geokbd-022-rich-editor-support-improvements http://www.code.ge/posts/geokbd-022-rich-editor-support-improvements#comments Sun, 18 Nov 2007 14:23:17 +0000 იოსები http://www.code.ge/geokbd/geokbd-022-rich-editor-support-improvements მორიგი განახლება მოიცავს შემდეგ გაუმჯობესებებს:

  • იმისათვის რათა მოხდეს ედიტორზე ქართული კლავიატურის მიბმა, აღარ არის საჭირო window ობიექტის onload ხდომილების გამოყენება.

    ნაცვლად ასეთი კონსტრუქციისა:

    window.onload = function() {
    GeoKBD.mapIFrame('elm1_ifr');
}

    უკვე საკმარისია მსგავსი კონსტრუქცია:

    GeoKBD.mapIFrame('elm1_ifr');
  • გარკვეულ შემთხვევბში მხოლოდ ედიტორის iframe ელემენტის იდენტიფიკატორის მითითება არ არის საკმარისი. ამიტომ mapIFrame() მეთოდს პირველ პარამეტრად შეგვიძლია გადავცეთ არა უბრალოდ იდენტიფიკატორი, არამედ ე.წ. callback ფუნქცია. მაგალითად FckEditor – ის ქართულ კლავიატურაზე მისაბმელად საჭიროა შემდეგი კონსტრუქცია:
    GeoKBD.mapIFrame(function() {
   var _el = null;
   if (_el = document.getElementById('FCKeditor1___Frame')) {
       return _el.contentDocument.getElementsByTagName('iframe')[0];
   }
});

    ეს საჭიროა გამომდინარე იქედან რომ FckEditor – ი iframe – ს შიგნით კიდევ ერთ iframe ელემენტს იყენებს.. თუმცა ნებისმიერ სპეციალურ შემთხვევაში callback ფუნქცია ძალიან სასარგებლოდ შეიძლება იქნას გამოყენებული…

  • დაიფიქსა ჩვეულებრივი ფორმის ელემენტების მიბმის პატარა პრობლემა რომელიც ელემენტის type ატრიბუტის არარსებობის შემთხვევაში გვხდებოდა
  • wysiwyg ედიტორთან მუშაობის დროს შესაძლებელია ქართულის ჩართვა/გამორთვა “~” კლავიშის მეშვეობით

სკრიპტის განახლებული ვერსია შესაძლებელია გადაიწეროთ SVN რეპოზიტორიდან.

]]> http://www.code.ge/posts/geokbd-022-rich-editor-support-improvements/feed 1 GeoKBD 0.2.1 – Rich Editor Support http://www.code.ge/posts/geokbd-021-rich-editor-support http://www.code.ge/posts/geokbd-021-rich-editor-support#comments Sat, 17 Nov 2007 13:05:28 +0000 იოსები http://www.code.ge/geokbd/geokbd-021-rich-editor-support GeoKBD – ს მორიგი განახლება მოიცავს ე.წ. Rich Editor(wysiwyg) – ინტეგრაციას, ამჯერად მისი მეშვეობით შესაძლებელია ნებისმიერ ასეთ ედიტორში ქართულად წერა.

მართალია ჯერ ნედლი და დაუხვეწავი გადაწყვეტაა მაგრამ მთავარია მუშაობს. განახლების გადაწერა ცხადია შესაძლებელია SVN რეპოზიტორიდან.

ამჯერად სკრიპტი გატესტილია შემდეგ ბრაუზერებში:

  • Safari Mac OS X
  • Opera
  • Mozilla FireFox

სკრიპტს დაემატა ერთი ახალი მეთოდი mapIFrame რომლის მეშვეობითაც შეძლებთ ედიტორში ქართულად წერის შესაძლებლობის რეალიზაციას.
მისი მიბმა ედიტორზე შეგიძლიათ განახორციელოდ შემდეგი ჯავასკრიპტ კონსტრუქციით:

window.onload = function() {
	GeoKBD.mapIFrame('myEditorId');
        //სადაც 'myEditorId თქვენი კომპონენტის იდენტიფიკატორია!
}

არსებული მუშა მაგალითი შესაძლებელია იხილოთ ამ მისამართზე.

P.S.
ექსპერიმენტის სახით მოვსინჯე და GeoKBD ავამუშავე TinyMCE – სთან.

]]> http://www.code.ge/posts/geokbd-021-rich-editor-support/feed 3 GeoKBD: პირველი განახლება http://www.code.ge/posts/geokbd-first-update http://www.code.ge/posts/geokbd-first-update#comments Fri, 26 Oct 2007 09:47:46 +0000 იოსები http://www.code.ge/javascript/geokbd-first-update პირველ რიგში დიდი მადლობა მინდა გადავუხადო გიორგი კობერიძეს აღმოჩენილი შეცდომისათვის სკრიპტში.

რადგან სრულფასოვნად ვერ გავტესტე სკრიპტი, ბუნებრივია რომ არ იყო გამორიცხული მას ჰქონოდა შეცდომები… ეს ასეც აღმოჩნდა :P და ეხლა უშეცდომოდ(იმედი მაქვს) მუშაობს ყველაფერი.

გარდა შეცდომის შესწორებისა რომელიც მდგომარებოდა ერთი და იგივე ფორმის ელემენტების ქართულ კლავიატურასთან მიბმაში, სკრიპტში ასევე შევიტანე სხვა მცირე ცვლილებები რომლებიც მის მოხმარებას უფრო გააიოლებს. ასევე დაფიქსულია Mac OS X Safari – ში აღმოჩენილი ბაგი, რომელიც ტექსტურ ველში პირველი სიმბოლოს აკრეფის დროს იყო.


მცირეოდენი საჭირო განმარტებები

ერთი ფორმის, მრავალი ველის კლავიატურასთან მიბმის საჭიროების შემთხვევაში ნაცვლად შემდეგი კონსტრუქციისა:

GeoKBD.map('my-form', 'my-field-one');
GeoKBD.map('my-form', 'my-field-two');

დინამიური მასივის საშუალებით უკვე შესაძლებელია ასეთი კონსტრუქციის გამოყენება:

GeoKBD.map('my-form', ['my-field-one', 'my-field-two']);

იმ შემთხვევაში თუ საჭირო ფორმის ყველა ელემენტის კლავიატურაზე მიბმა საკმარისია შემდეგი კონსტრუქცია:

GeoKBD.map('my-form');


სკრიპტის გადაწერა შეგიძლიათ პირდაპირ SVN რეპოზიტორიდან

]]> http://www.code.ge/posts/geokbd-first-update/feed 8 ქართული კლავიატურის სკრიპტი http://www.code.ge/posts/georgian-keyboard http://www.code.ge/posts/georgian-keyboard#comments Tue, 23 Oct 2007 13:09:54 +0000 იოსები http://www.code.ge/javascript/georgian-keyboard ესე იგი მინდოდა თუ არ მინდოდა ირაკლი ნადარეიშვილმა მიბიძგა და ქართული კლავიატურის სკრიპტი დავწერე…

სკრიპტი ძალიან მარტივია, და მისი მიბმა შეგიძლიათ ნებისმიერ ტექსტურ ველზე, ასევე მას აქვს ქართული კლავიატურის ჩართვისა და გამორთვის მხარდაჭერა. სიმბოლოების ტრანსლირებისათვის გამოვიყენე ირაკლის მიერ წლების წინ შემუშავებული ალგორითმი (ორიგინალი შეგიძლიათ იხილოთ აქ)

სკრიპტის მუშა მაგალითი შეგიძლიათ იხილოთ ამ მისამართზე
სკრიპტის უახლესი ვერსიის გადმოწერა შეგიძლიათ ამ მისამართიდან

რა უპირატესობები აქვს ამ სკრიპტს? იგი არის პატარა, კოდი არის ძალიან მარტივი და გასაგები, არ აბინძურებს ვებ აპლიკაციის სკოუპს რადგან იგი მთლიანად არის ენკაპსულირებული თავისსავე სკოუპში რაც არის იმის გარანტია რომ მისი გამოყენება შეგიძლია მარტივად და უსაფრთხოდ თუნდაც სხვა ანალოგიური დანიშნულების სკრიპტებთან ერთად.

ასევე საგულისხმოა ის რომ String ობიექტს ემატება ორი მეთოდი ესენია:

  1. translateToKA() – მეთოდი რომელსაც შეუძლია ნებისმიერი სტრიქონის პირდაპირ გადაყვანა ქართულ უნიკოდში. რაც ნიშნავს იმას რომ ამ მეთოდის გამოყენება თამამად შეგიძლიათ თქვენს სკრიპტებში.

    მეთოდის გამოყენება შეგიძლიათ შემდეგნაირად:

    var str = "es aris nebismieri teqsti";
alert(str.translateToKA());

//ან პირდაპირ ასე
alert("es aris text literali".translateToKA());
  2. pasteTo([html form element]) – რომელსაც პარამეტრად გადაეცემა ფორმის ელემენტი. ეს მეთოდი ტექსტის კოპირებას ახდენს ან პირდაპირ თუ ელემენტის მნიშვნელობა ცარიელია, ან იმ ადგილას სადაც ზის კურსორი, ან ჩაანაცვლებს მონიშნულ ტექსტს ახალი ტექსტით.

    მეთოდის გამოყენება შეგიძლიათ შემდეგნაირად:

    var str = "es aris nebismieri teqsti";
str.translateToKA().pasteTo(document.forms['my-form-name']['my-field-name']);

კოდი ვრცელდება MIT ლიცენზიით

        /*
	 * GeoKBD 0.1 - Georgian keyboard and text convertation library
	 *
	 * Copyright (c) 2007 Ioseb Dzmanashvili (http://www.code.ge)
	 * Licensed under the MIT (http://www.opensource.org/licenses/mit-license.php)
	 */

გამოყენების მაგალითი

HTML კოდი:

1
2
3
4
5
6
7
8
9
10
11
12
<form name="my-form" action="">
  <input type="checkbox" name="geo" checked="checked"/>
  <br />
  <textarea name="post" cols="40" rows="8"></textarea>
</form>

<br />
<form name="another-form" action="">
  <input type="checkbox" name="geo1" checked="checked"/>
  <br />
  <textarea name="frm" cols="40" rows="8"></textarea>
</form>

JavaScript კოდი:

1
2
GeoKBD.map('my-form', 'post');
GeoKBD.map('another-form', 'frm', 'geo1');

ამ კოდის შესრულების შემდეგ ორივე ფორმაში შესაძლებელი იქნება ქართულად ბეჭდვა, კლავიატურის გადართვის გარეშე.

სკრიპტის მუშაობის პრინციპი მარტივია, GeoKBD ობიექტის map მეთოდს გადავცემთ სამ პარამეტრს:

  1. HTML ფორმის სახელი ან თავად HTML ფორმა
  2. იმ ველის სახელი რომელშიც შესაძლებელი უნდა იყოს ქართულად ბეჭდვა ან თუ გსურთ რომ ფორმის ყველა ველში იყოს შესაძლებელი ქართულად ბეჭდვა, მაშინ ამ პარამეტრის გადაცემა არ არის აუცილებელი
  3. კლავიატურის გადამრთველი ველის(checkbox) სახელი (არ არის აუცილებელი პარამეტრი, თუ ამ პარამეტრს არ გადავცმეთ გამოყენებული იქნება სახელი ‘geo’)


პროგრამის სრული კოდი:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
(function() {
 
  /*
   * GeoKBD 0.1 - Georgian keyboard and text convertation library
   *
   * Copyright (c) 2007 Ioseb Dzmanashvili (http://www.code.ge)
   * Licensed under the MIT (http://www.opensource.org/licenses/mit-license.php)
   */
 
  String.prototype.pasteTo = function(field) {
    field.focus();
    if (document.selection) {
      var selection = document.selection;
      var range = selection.createRange();
      range.colapse;
      if (range) {
        range.text = this;
      }
    } else if (field.selectionStart || field.selectionEnd) {
      var scrollTop = field.scrollTop;
      var start = field.selectionStart;
      var end = field.selectionEnd;
      var value = field.value.substring(0, start) + this + field.value.substring(end, field.value.length);
      field.value = value;
      field.scrollTop = scrollTop;
      field.selectionStart = start + this.length;
      field.selectionEnd = start + this.length;
    } else {
      field.value += this;
    }
  },
 
  String.prototype.translateToKA = function() {
   
    /**
     * Original idea by Irakli Nadareishvili
     * http://www.sapikhvno.org/viewtopic.php?t=47&postdays=0&postorder=asc&start=10
     */
    var index, chr, text = [], symbols = "abgdevzTiklmnopJrstufqRySCcZwWxjh";
   
    for (var i = 0; i < this.length; i++) {
      chr = this.substr(i, 1);
      if ((index = symbols.indexOf(chr)) >= 0) {
        text.push(String.fromCharCode(index + 4304));
      } else {
        text.push(chr);
      }
    }
   
    return text.join('');
   
  },
 
  GeoKBD = {
   
    event: {
     
      get: function(e) {
        return e || window.event;
      },
     
      getKeyCode: function(e) {
        e = this.get(e);
        return e.keyCode || e.which;
      },
     
      targetIs: function(e, tagName) {
        e = this.get(e);
        var t = e.target || e.srcElement;
        return t.tagName.toLowerCase() == tagName ? t : null;
      }
     
    },
   
    map: function(form, contentFieldName, switcher) {
     
      var self = this;
     
      form = (typeof form == 'string') ? document.forms[form] : form;
      switcher = switcher || 'geo';
     
      form.onkeypress = function(e) {
       
        e = self.event.get(e);
        if (e.altKey || e.ctrlKey) return;
       
        var target, fieldName = contentFieldName, _switcher = switcher, keyCode = self.event.getKeyCode(e);
       
        if (keyCode == 96) {
          this[_switcher].checked = !this[_switcher].checked;
          return false;
        }
       
        if (!this[_switcher].checked) return;
       
        if ((target = (self.event.targetIs(e, 'textarea') || self.event.targetIs(e, 'input')))) {
          if (fieldName && (target.name != fieldName)) return;
          text = String.fromCharCode(keyCode);
          kaText = text.translateToKA();
          if (kaText != text) {
            kaText.pasteTo(target);
            return false;
          }
        }
      }
     
      form = null;
     
    }
   
  };
 
  window.GeoKBD = GeoKBD;

})();
]]> http://www.code.ge/posts/georgian-keyboard/feed 25