Freenetis Wiki - Příspěvky uživatele [cs]

Автоматизированное тестирование в NetBeans

2014-06-07T15:24:29Z

Sivosha:

[[cs:Automatické testování v NetBeans]]
[[en:Automatic testing in NetBeans]]

== Интеграция PHPUnit в NetBeans ==

=== Установка пакетов ===

в Ubuntu/Debianu:

sudo apt-get install phpunit

в Fedora:

sudo yum install phpunit

=== Установка NetBeans ===

Введите путь к PHPUnit (/usr/bin/phpunit) вручную или с помощью '''Поиск'''

Инструменты>Настройки>PHP>Модульное тестирование

== Создание тестов ==

В контекстном меню файла/папки исходного теста, выберите

Инструменты>Создать PHPUnit тесты

Введите путь к папке (папки в корневом каталоге с тестами FreenetIS), в котором будет автоматически генерироваться тестовые файлы. Это будет база для создания тестов выбранного файла. В этом файле naimplementujte есть тесты для каждого метода.

== Выполнение тестов ==

В окне Свойства проекта, позволит PHPUnit '''Используйте начальной загрузки''' и '''Используйте Bootstrap для создания новых модульных тестов''' как программа начальной загрузки файла, выберите ''index.php'' в корневом каталоге FreenetIS.

В контекстном меню исходного файла, который вы хотите проверить, выберите ''Test''. Или в меню Run выбрать проект ''Test''. Это позволит автоматически проверять все тесты и просматривать результаты в окне Результаты теста.

Автоматизированное тестирование в NetBeans

2014-06-07T15:23:58Z

Sivosha: Založena nová stránka: cs:Automatické testování v NetBeans en: == Интеграция PHPUnit в NetBeans == === Установка пакетов === в Ubuntu/Debianu: sudo apt...

[[cs:Automatické testování v NetBeans]]
[[en:]]

== Интеграция PHPUnit в NetBeans ==

=== Установка пакетов ===

в Ubuntu/Debianu:

sudo apt-get install phpunit

в Fedora:

sudo yum install phpunit

=== Установка NetBeans ===

Введите путь к PHPUnit (/usr/bin/phpunit) вручную или с помощью '''Поиск'''

Инструменты>Настройки>PHP>Модульное тестирование

== Создание тестов ==

В контекстном меню файла/папки исходного теста, выберите

Инструменты>Создать PHPUnit тесты

Введите путь к папке (папки в корневом каталоге с тестами FreenetIS), в котором будет автоматически генерироваться тестовые файлы. Это будет база для создания тестов выбранного файла. В этом файле naimplementujte есть тесты для каждого метода.

== Выполнение тестов ==

В окне Свойства проекта, позволит PHPUnit '''Используйте начальной загрузки''' и '''Используйте Bootstrap для создания новых модульных тестов''' как программа начальной загрузки файла, выберите ''index.php'' в корневом каталоге FreenetIS.

В контекстном меню исходного файла, который вы хотите проверить, выберите ''Test''. Или в меню Run выбрать проект ''Test''. Это позволит автоматически проверять все тесты и просматривать результаты в окне Результаты теста.

Automatic testing in NetBeans

2014-06-07T15:13:38Z

Sivosha: Založena nová stránka: cs:Automatické testování v NetBeans ru:Автоматизированное тестирование в NetBeans == Integration of PHPUnit into NetBeans == ===...

[[cs:Automatické testování v NetBeans]]
[[ru:Автоматизированное тестирование в NetBeans]]

== Integration of PHPUnit into NetBeans ==

=== Installing packages ===

in Ubuntu/Debianu:

sudo apt-get install phpunit

in Fedora:

sudo yum install phpunit

=== Setting NetBeans ===

Enter the path to PHPUnit (/usr/bin/PHPUnit) manually or using the '''Search''' window

Tools> Preferences> PHP> Unit Testing

== Creating tests ==

In the context menu of the test source file/folder, select

Tools> Create PHPUnit tests

Enter the path to the folder (the folder is in the root directory of tests FreenetIS). The test files will be automatically generated there. This this is a basis for creating tests selected file. In this file naimplementujte tests for each method.

== Running tests ==

In the Project Properties window, enable PHPUnit '''Use Bootstrap''' and '''Use Bootstrap for Creating New Unit Tests''' as a Bootstrap file, select ''index.php'' in the root directory FreenetIS.

In the context menu of the source file that you want to test, select ''Test''. Or in the Run menu select ''Test'' project. Then it will automatically check all of the tests and view the results in the Test Results window.

Персонал культуры

2014-06-07T14:47:15Z

Sivosha:

[[cs:Štábní kultura]]
[[en:Staff culture]]

Разработчики FreenetISu рекомендуют следовать определенным правилам для повышения читабельности и согласованности исходных кодов.

Каждый исходный файл должен начинаться со следующего кода:

<?php defined('SYSPATH') or die('No direct script access.');
/*
* This file is part of open source system FreenetIS
* and it is released under GPLv3 licence.
*
* More info about licence can be found:
* http://www.gnu.org/licenses/gpl-3.0.html
*
* More info about project can be found:
* http://www.freenetis.org/
*
*/

=== Смещение ===

Смещение исходного текста осуществляется с помощью клавиши табуляции. если не указано иное,

=== Перенос ===

Строки кодов контроллеров, моделей и помощи не должны превышать 80 символов.
Для более длинных строк исходный код должен соответствовать следующим правилам:

'' 'Коробки Wrap'''

array
(
'a', 'b', c', 'd', 'e',
'f', 'g'
);

array
(
'a' => val1,
'b' => val2
);

'''Запись аргументов функции'''

Аргументы в определениях и декларациях.

''Используйте для смещения внутренних аргументов около 2 табуляций''

funkce(arg1, arg2,
arg3, arg4
);

или

funkce(
arg1, arg2,
arg3, arg4
);

'''Метод цепочки объектов'''

Эта запись является подходящей, если строка кода не превышает 80 символов.

''Используйте для смещения около 2 табуляций''

$object->method1()
->method2();

'''Соединение условий'''

if (conditionA && (
conditionB ||
conditionC
))
{
...
}

Персонал культуры

2014-06-07T14:46:53Z

Sivosha: Založena nová stránka: cs:Štábní kultura en:Stuff culture Разработчики FreenetISu рекомендуют следовать определенным правилам дл...

[[cs:Štábní kultura]]
[[en:Stuff culture]]

Разработчики FreenetISu рекомендуют следовать определенным правилам для повышения читабельности и согласованности исходных кодов.

Каждый исходный файл должен начинаться со следующего кода:

<?php defined('SYSPATH') or die('No direct script access.');
/*
* This file is part of open source system FreenetIS
* and it is released under GPLv3 licence.
*
* More info about licence can be found:
* http://www.gnu.org/licenses/gpl-3.0.html
*
* More info about project can be found:
* http://www.freenetis.org/
*
*/

=== Смещение ===

Смещение исходного текста осуществляется с помощью клавиши табуляции. если не указано иное,

=== Перенос ===

Строки кодов контроллеров, моделей и помощи не должны превышать 80 символов.
Для более длинных строк исходный код должен соответствовать следующим правилам:

'' 'Коробки Wrap'''

array
(
'a', 'b', c', 'd', 'e',
'f', 'g'
);

array
(
'a' => val1,
'b' => val2
);

'''Запись аргументов функции'''

Аргументы в определениях и декларациях.

''Используйте для смещения внутренних аргументов около 2 табуляций''

funkce(arg1, arg2,
arg3, arg4
);

или

funkce(
arg1, arg2,
arg3, arg4
);

'''Метод цепочки объектов'''

Эта запись является подходящей, если строка кода не превышает 80 символов.

''Используйте для смещения около 2 табуляций''

$object->method1()
->method2();

'''Соединение условий'''

if (conditionA && (
conditionB ||
conditionC
))
{
...
}

Staff culture

2014-06-07T14:46:00Z

Sivosha:

[[cs:Štábní kultura]]
[[ru:Персонал культуры]]

Developers FreenetISu is recommended to follow the defined rules to increase readability and consistency of source codes.

Each source file should start with the following code:
<?php defined('SYSPATH') or die('No direct script access.');
/*
* This file is part of open source system FreenetIS
* and it is released under GPLv3 licence.
*
* More info about licence can be found:
* http://www.gnu.org/licenses/gpl-3.0.html
*
* More info about project can be found:
* http://www.freenetis.org/
*
*/

=== Offsetting ===

Offsetting the source text is done using the Tab key. unless otherwise stated, it is assumed now that the offset.

=== Wrap ===

Line codes controllers, models and helpers should not exceed 80 characters.
For lines exceeding this length wraps source code according to the following rules:

'' 'Wrap boxes'''

array
(
'a', 'b', c', 'd', 'e',
'f', 'g'
);

array
(
'a' => val1,
'b' => val2
);

'''Wrap function arguments'''

Wrap the arguments in definitions and declarations.

'' Used to offset internal arguments about 2 tabs''

funkce(arg1, arg2,
arg3, arg4
);

or

funkce(
arg1, arg2,
arg3, arg4
);

'''Chained method objects'''

This wrap is suitable if a line of code does not exceed 80 characters.

'' It is used to offset the 2 tabs''

$object->method1()
->method2();

'''Compound conditions'''

if (conditionA && (
conditionB ||
conditionC
))
{
...
}

Štábní kultura

2014-06-07T14:45:18Z

Sivosha:

[[en:Staff culture]]
[[ru:Персонал культуры]]
Vývojářům FreenetISu je doporučeno dodržovat zde definované pravidla pro zvýšení čitelnosti a jednotnosti zdrojových kódů.

Každý zdrojový soubor by měl začínat následujícím kódem:

<?php defined('SYSPATH') or die('No direct script access.');
/*
* This file is part of open source system FreenetIS
* and it is released under GPLv3 licence.
*
* More info about licence can be found:
* http://www.gnu.org/licenses/gpl-3.0.html
*
* More info about project can be found:
* http://www.freenetis.org/
*
*/

=== Odsazování ===

Odsazování zdrojového textu se provádí pomocí tabulátoru. pokud není uvedeno jinak, předpokládá se právě tato velikost odsazení.

=== Zalamování ===

Řádek kódy controllerů, modelů a helperů by neměl přesahovat 80 znaků.
Pro řádky přesahující tuto délku zalamujeme zdrojový kód dle následujících pravidel:

'''Zalamování polí'''

array
(
'a', 'b', c', 'd', 'e',
'f', 'g'
);

array
(
'a' => val1,
'b' => val2
);

'''Zalamování argumentů funkcí'''

Zalamujeme i argumenty v definicích a deklaracích.

''Používá se odsazení vnitřních argumentů o 2 tabulátory''

funkce(arg1, arg2,
arg3, arg4
);

nebo

funkce(
arg1, arg2,
arg3, arg4
);

'''Řetězené metody objektů'''

Toto zalamování je vhodné i pokud řádek kódu nepřesahuje 80 znaků.

''Používá se odsazení o 2 tabulátory''

$object->method1()
->method2();

'''Složené podmínky'''

if (conditionA && (
conditionB ||
conditionC
))
{
...
}

Štábní kultura

2014-06-07T14:45:06Z

Sivosha:

[[en:Staff culture]]
[[ru:Персонал культура]]
Vývojářům FreenetISu je doporučeno dodržovat zde definované pravidla pro zvýšení čitelnosti a jednotnosti zdrojových kódů.

Každý zdrojový soubor by měl začínat následujícím kódem:

<?php defined('SYSPATH') or die('No direct script access.');
/*
* This file is part of open source system FreenetIS
* and it is released under GPLv3 licence.
*
* More info about licence can be found:
* http://www.gnu.org/licenses/gpl-3.0.html
*
* More info about project can be found:
* http://www.freenetis.org/
*
*/

=== Odsazování ===

Odsazování zdrojového textu se provádí pomocí tabulátoru. pokud není uvedeno jinak, předpokládá se právě tato velikost odsazení.

=== Zalamování ===

Řádek kódy controllerů, modelů a helperů by neměl přesahovat 80 znaků.
Pro řádky přesahující tuto délku zalamujeme zdrojový kód dle následujících pravidel:

'''Zalamování polí'''

array
(
'a', 'b', c', 'd', 'e',
'f', 'g'
);

array
(
'a' => val1,
'b' => val2
);

'''Zalamování argumentů funkcí'''

Zalamujeme i argumenty v definicích a deklaracích.

''Používá se odsazení vnitřních argumentů o 2 tabulátory''

funkce(arg1, arg2,
arg3, arg4
);

nebo

funkce(
arg1, arg2,
arg3, arg4
);

'''Řetězené metody objektů'''

Toto zalamování je vhodné i pokud řádek kódu nepřesahuje 80 znaků.

''Používá se odsazení o 2 tabulátory''

$object->method1()
->method2();

'''Složené podmínky'''

if (conditionA && (
conditionB ||
conditionC
))
{
...
}

Smazání větve

2014-06-07T14:42:59Z

Sivosha:

[[en:Deleting branches]]
[[ru:Удаление ветви]]
Pokud je větev hotova a sloučená do hlavní větve, odstraníme ji z SVN příkazem:

svn delete https://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/branches/název_větve -m "Větev mažu, protože už je hotová a sloučená do hlavní větve"

Deleting branches

2014-06-07T14:42:45Z

Sivosha:

[[cs:Smazání větve]]
[[ru:Удаление ветви]]

If a branch is completed and merged into the main branch, remove it from the SVN command:

svn delete https://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/branches/branch_name -m "The branch is removed because it is integrated with the main branch"

Удаление ветви

2014-06-07T14:42:08Z

Sivosha: Založena nová stránka: cs:Smazání větve en:Deleting branches Если ветвь завершена, и добавлена в основную ветку, удалите ее из SVN...

[[cs:Smazání větve]]
[[en:Deleting branches]]

Если ветвь завершена, и добавлена в основную ветку, удалите ее из SVN командой:

svn delete https://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/branches/имя_ветки -m "Ветка удаляется потому что она объединена с главной ветвью"

Smazání větve

2014-06-07T14:41:30Z

Sivosha:

[[en:Deleting branches]]
[[ru:Удаление ветви]]
If a branch is completed and merged into the main branch, remove it from the SVN command:

svn delete https://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/branches/branch_name -m "The branch is removed because it is integrated with the main branch"

Import and export of database

2014-06-07T14:39:21Z

Sivosha:

[[cs:Import a export databáze]]
[[ru:Импорт и экспорт базы данных]]

Import a export databáze

2014-06-07T14:37:36Z

Sivosha:

[[en:Import and export of database]]
[[ru:Импорт и экспорт базы данных]]
Při vývoji je často potřeba pracovat s daty ostré databáze. Prázdná databáze po instalaci pro mnoho testování nestačí.

== Import dat do databáze ==

Import SQL souboru s obsahem databáze je možné přes uživatelské rozhraní Phpmyadmina. Velké soubory pak ale často narazí na časový a datový limit PHP. Tyto limity je možné do jisté míry měnit v souboru

/etc/php5/apache2/php.ini

U velkých souborů toto nemusí stačit. Proto je snadné použití příkazové řádky. Stačí mít na počítači nekomprimovaný soubor SQL s daty k importu. Je potřeba mít na cílovém MySQL serveru prázdnou databázi. Pro import pak stačí v konzoli napsat

mysql -u username -p freenetis < freenetis.sql

Po importu databáze je nutné v Phpmyadminovi upravit některé položky v tabulce config. Jde o položky
* protocol (na svém PC pro vývoj používáte typicky http místo https)
* domain (na svém PC pro vývoj máte doménu localhost místo třeba freenetis.sdruzeni.net)
* suffix (přípona za doménou, na serveru je to obvykle pouze /, pro localhost to je obvykle /freenetis/, záleží na vašem nastavení virtualhostu v Apachi)
Jestliže nenaběhne FreenetIS na vaší lokální stránce (typicky localhost/freenetis) kvůli selhání upgradu databáze, pak navštivte v phpmyadminu tabulku config a upravte položku db_schema_version na číslo verze, které najdete v souboru application/upgrade_sql/upgrade_sql.php.
Jestliže přihlašovací stránka naběhne, ale přihlášení selže na neznámé chybě, pak ověřte, jestli se celý import dat provedl správně. V případě větší databáze se import nemusí provést správně a některé tabulky se nestihnou vytvořit, například tabulka users klíčová pro přihlášení. V tomto případě používejte import výhradně přes příkazovou řádku a nikoli přes webové rozhraní phpmyadmina.

=== Tip ===
Po importu pusťte v phpmyadminovi následující SQL dotaz
update users, (select password as newpass from users where login='vaslogin') u set password = u.newpass
Můžete tak snadněji testovat práva, protože takto všem uživatelům nastavíte vaše heslo podle vašeho loginu.

=== Tip ===
Výsledný SQL dotaz po importu databáze s produkčními daty na lokální vývojářský počítač:
update config set value = 'http' where name = 'protocol';
update config set value = 'localhost' where name = 'domain';
update config set value = '/freenetis/' where name = 'suffix';
update users, (select password as newpass from users where login='vaslogin') u set password = u.newpass

== Export dat z databáze ==

V příkazové řádce se pak export databáze do souboru provede obdobně:

mysqldump -u username -p freenetis --routines > freenetis.sql

== Skript All in one ==

Následující skript provádí víceméně vše předchozí automaticky za vás. Stačí jenom správně nastavit proměnné, zajít si na kávu a po návratu je váš lokální počítač připraven.

#!/bin/bash

############################################################################################
# #
# Autor: Michal Kliment #
# Popis: Tento skript umoznuje vyvojarum FreenetISu snadnejsi import databaze z jejich #
# ostre instalace FreenetISu na jejich lokalni pocitac. #
# #
# Datum: 26. 7. 2011 #
# #
############################################################################################

############################################################################################
# N A S T A V E N I L O K A L N I I N S T A L A C E F R E E N E T I S U #
############################################################################################

# Nazev lokalni databaze
LOCAL_DB_NAME="freenetis"
# Uzivatel lokalni databaze
LOCAL_DB_USER="freenetis"
# Heslo k lokalni databazi
LOCAL_DB_PASSWORD="freenetis"

# Protokol lokalniho freenetisu, http nebo htts
PROTOCOL="http"
# Domena lokalniho freenetis, pravdepodobne localhost
DOMAIN="localhost"
# Pripona adresy lokalniho freenetisu, pravdepodobne /freenetis/
SUFFIX="/freenetis/"
# Uzivatel freenetisu, jehoz heslo se nastavi vsem uzivatelum v systemu
USER_LOGIN="admin"

############################################################################################
# N A S T A V E N I "O S T R E" I N S T A L A C E F R E E N E T I S U #
############################################################################################

# Nazev "ostre" databaze
REMOTE_DB_NAME="freenetis"
# Uzivatel "ostre" databaze
REMOTE_DB_USER="freenetis"
# Heslo k "ostre" databazi
REMOTE_DB_PASSWORD="freenetis"

# Uzivatel pro pristup na "ostry" freenetis pres SSH
REMOTE_USER="root"
# Adresa "ostreho" freenetisu pro SSH
REMOTE_HOST="host"

############################################################################################
# S A M O T N Y S K R I P T - N E M E N I T ! #
############################################################################################

echo "Vytvarim zalohu lokalni databaze $LOCAL_DB_NAME..."
mysqldump -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME --routines > freenetis-backup-`date +%Y%m%d%H%M`.sql 2>/dev/null

echo "Odstranuji lokalni databazi $LOCAL_DB_NAME..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD -e "DROP DATABASE $LOCAL_DB_NAME;"

echo "Vytvarim novou prazdnou databazi $LOCAL_DB_NAME..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD -e "CREATE DATABASE $LOCAL_DB_NAME DEFAULT CHARACTER SET utf8 COLLATE utf8_czech_ci;"

echo "Importuji do ni data primo z ostre databaze, tato operace chvili potrva..."
ssh $REMOTE_USER@$REMOTE_HOST "mysqldump -u $REMOTE_DB_USER --password=$REMOTE_DB_PASSWORD $REMOTE_DB_NAME --routines" | mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME

echo "Nastavuji protokol na $PROTOCOL..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME -e "update config set value = '$PROTOCOL' where name = 'protocol';"

echo "Nastavuji domenu na $DOMAIN..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME -e "update config set value = '$DOMAIN' where name = 'domain';"

echo "Nastavuji suffic na $SUFFIX..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME -e "update config set value = '$SUFFIX' where name = 'suffix';"

echo "Nastavuji vsem uzivatelum stejne heslo jako je heslo pro uzivatele $USER_LOGIN..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME -e "update users, (select password as newpass from users where login='$USER_LOGIN') u set password = u.newpass"

echo "Vyprazdnuji e-mailovou frontu..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME -e "TRUNCATE TABLE email_queues;"

Профайлер

2014-06-07T14:36:11Z

Sivosha:

[[cs:Profiler]]
[[en:Profiler (english)]]

Profiler в коде может работать следующим образом:

$this->profiler = new Profiler;
// некоторые из ваших действий и вопросов
echo $this->profiler->render(TRUE);

Профайлер

2014-06-07T14:35:53Z

Sivosha: Založena nová stránka: cs:Profiler en:Profiler (english) en:Profiler (english) Profiler в коде может работать следующим образом: $this->profiler =...

[[cs:Profiler]]
[[en:Profiler (english)]]

[[en:Profiler (english)]]
Profiler в коде может работать следующим образом:

$this->profiler = new Profiler;
// некоторые из ваших действий и вопросов
echo $this->profiler->render(TRUE);

Profiler (english)

2014-06-07T14:34:24Z

Sivosha:

[[cs:Profiler]]
[[ru:Профайлер]]

Profiler can be run anywhere in the code as:

$this->profiler = new Profiler;
// some of your actions and questions
echo $this->profiler->render(TRUE);

Profiler

2014-06-07T14:30:56Z

Sivosha:

[[en:Profiler (english)]]
[[ru: Профайл]]
Profiler si v libovolnem miste kodu muzete spustit takto:

$this->profiler = new Profiler;
// nejake vase akce a dotazy
echo $this->profiler->render(TRUE);

Automatické testování v NetBeans

2014-06-07T14:28:02Z

Sivosha:

[[en:Automatic testing in NetBeans]]
[[ru:Автоматизированное тестирование в NetBeans]]

== Integrace PHPUnit do NetBeans ==

=== Instalace balíků ===

v Ubuntu/Debianu:

sudo apt-get install phpunit

ve Fedoře:

sudo yum install phpunit

=== Nastavení NetBeans ===

Zadat cestu k binárce PHPUnit (obvykle /usr/bin/phpunit) ručně, nebo pomocí tlačítka '''Search''' v okně

Nástroje > Předvolby > PHP > Unit Testing

== Vytvoření testů ==

V kontextovém menu testovaného zdrojového souboru/složky vyberte

Nástroje > Create PHPUnit tests

zadejte cestu ke složce (složka tests v kořenovém adresáři FreenetISu), do které se budou automaticky generovat testovací soubory. Dojde k vygenerování kostry pro vytváření testů vybraného souboru. Do tohoto souboru naimplementujte testy pro jednotlivé metody.

== Spuštění testů ==

Ve vlastnostech projektu povolte v okně PHPUnit '''Use Bootstrap''' a '''Use Bootstrap for Creating New Unit Tests''' a jako Bootstrap soubor vyberte ''index.php'' v kořenovém adresáři FreenetISu.

V kontextovém menu zdrojového souboru, který chcete otestovat, vyberte možnost ''Test''. Případně v menu Run vybrat ''Test project''. Následně proběhne automatická kontrola všech testů a zobrazení výsledků v okně Test Results.

Автоматическое тестирование

2014-06-07T14:27:03Z

Sivosha:

[[en:Automatic testing]]
[[cs:Automatické testování]]

Автоматизированное тестирование используется в качестве обратной связи с разработчиком и контроля над его действиями.

== Архитектура теста ==

Испытания полностью автоматизированы (Вам не нужно тестировать программы, необходимо только доставить данные для испытаний) и автоматически вносятся изменения в исходный код.

Тесты позволяют проверить'''модели''','''помощники''' и'''контроллеры'''. Другие части системы проверяются только на корректность синтаксиса.

Тесты по юнит-тестам не сравнивают полученные значения функций, а только проверяют не является ли ошибкой завершения работы.

'''Тесты поддерживаются в *UNIX операционных системах.'''

=== Получение информации о исходном коде ===

Получение информации о исходном коде выполняется автоматически с помощью скрипта, который проходит через все модули и получая от них необходимые. Эти данные хранятся в документе XML ('' / application / vendors/ unit_tester / unit_testing_config.xml'').

== Установка тестов ==

Установка необходимых библиотек:

v Ubuntu/Debianu:

sudo apt-get install curl perl libxml-writer-perl libxml-dom-perl

Fedora:

sudo yum install curl perl perl-XML-Writer perl-XML-DOM php-xml

'''Возможности:'''

cd /var/www/freenetis
chmod +x ./application/vendors/unit_tester/tester.sh

'''Предотвращение отправки e-mail/SMS т.д.:'''

Do config.php přidejte:

$config['unit_tester'] = TRUE;

== Выполнение тестов ==

'' 'Внимание: Тесты возможны только на локальном сервере разработки!'''

cd / var / www / freenetis / application / vendors / unit_tester
. / tester.sh <URL> <LOGIN_NAME> <PASSWORD>

'' Примечание: время работы всех тестов на Intel Core i5 2,53 ГГц с Ubuntu 11.04 составляет около четырех минут''.

'''Пример с аргументами'''

. / Tester.sh-O http://localhost/freenetis Админ 123456

=== Аргументы тестового скрипта ===

$. / Tester.sh - помощь
Скрипт для тестирования FreenetIS
ИСПОЛЬЗОВАНИЕ: tester.sh [параметры] URL Имя пользователя Пароль

Опции:
-О, --open-browser Открыть браузер с ошибками моделей или помощников
автоматически, после обнаружения ошибок.
-S, --skip-syntax Пропустить проверку синтаксиса всех файлов
-M, --skip-models Пропустить тест моделей
-H, --skip-helpers Пропустить тест помощников
-C, --skip-controllers Пропустить тест контроллеров
-E, --enable-stats Включить статистику и тесты

== Редактирование проверяемой информации ==

Автоматически сгенерированных значений теста недостаточно для тестирования, поэтому уместно добавить некоторую дополнительную информацию.

Например, определите модель в файле конфигурации, найдите соответствующие объекты (как заголовок и имена атрибутов).

'' 'Модель генерируется автоматически:'''

<MODEL name="test">
<method name="testovaci_funkce" autogenerate="on">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</ attributes>
<values>
<input>
value = "" /> <параметр
value = "Array ()" /> <параметр
</input>
</ values>
</ Method>
</ model>

Очень важным атрибутом метода является '''автоформирование'''. Если вы вносите изменения в методе и и устанавливаете их в '''off''' то при запуске тестирования изменения игнорируются.

Тег'''ввод''' можно рассматривать как набор тестовых значений метода.

'''Если вы не хотите, что метод был протестирован вообще (обычно это методы, которые зависят от объектов или вставки данных в базу данных), это может быть достигнуто следующим образом:'''

<model name="test">
<method name="testovaci_funkce" autogenerate="off">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</attributes>
<values>
</values>
</method>
</model>

'''Идеальные тестовые данные (попытка вставить пустые или бессмысленные значения) для нашей тестовой модели может выглядеть следующим образом:'''

<model name="test">
<method name="testovaci_funkce" autogenerate="off">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</attributes>
<values>
<input>
<param value="" />
<param value="" />
</input>
<input>
<param value="" />
<param value="array()" />
</input>
<input>
<param value="1" />
<param value="array('id' => '1')" />
</input>
<input>
<param value="abd'se$#@`" />
<param value="abd'se$#@`" />
</input>
<input>
<param value="1" />
<param value="array('id' => '1sef%se@š`', 'Ijnfsief' => 'se2', 'sef$a;!')" />
</input>
</values>
</method>
</model>

=== Дополнительные возможности для контроллеров ===

Контроллеры могут также отправлять данные с помощью POST и HTTP GET, только для проверки входных параметров добавьте параметры в виде:

<param name="post_name" type="post" value="hodnota" />
<param name="get_name" type="get" value="hodnota" />

Работа редактирования испытания действия документа ===

После каждого изменения файла конфигурации, вы должны проверить его корректность с помощью прилагаемого DTD (''/application/vendors/unit_tester/unit_testing_config.xml''), так как сам тест позволяет допустимые конфигурации!

В Netbeans IDE проверка выполняется выбором конфигурационного файла и запуском через контекстное меню проверки XML.

== Статистика и критерии ==

Тесты являются инструментом для анализа моделей и контроллеров. Их можно включить с помощью параметра <code>-e</code>.

Результаты тестов модели отобража.тся в выходноv HTML файл, наряду с тестами.

Результаты для контроллеров сохраняются в файле <code>curl/cstats</code>, который состоит из четырех столбцов, разделенных табуляцией.

* Первый столбец содержит информацию о времени контроллера в секундах.
* Второй столбец показывает потребление памяти в МБ для реализации.
* Третий столбец - URL запроса.
* Четвертый включает HTTP POST контроллера.

'' 'Пример: запрос о 10 наибольших потреблений памяти:'''

cat curl/cstats | cut -f 1,2,3 | sort -n -r -k 2,2 | head -n 10

'' Примечание: В данном руководстве рассматривается путь к FreenetIS предусмотренный в [[Установка FreenetIS]]''

Автоматическое тестирование

2014-06-07T14:26:47Z

Sivosha: Založena nová stránka: en:Automatic testing cz:Automatické testování Автоматизированное тестирование используется в качестве обр...

[[en:Automatic testing]]
[[cz:Automatické testování]]

Автоматизированное тестирование используется в качестве обратной связи с разработчиком и контроля над его действиями.

== Архитектура теста ==

Испытания полностью автоматизированы (Вам не нужно тестировать программы, необходимо только доставить данные для испытаний) и автоматически вносятся изменения в исходный код.

Тесты позволяют проверить'''модели''','''помощники''' и'''контроллеры'''. Другие части системы проверяются только на корректность синтаксиса.

Тесты по юнит-тестам не сравнивают полученные значения функций, а только проверяют не является ли ошибкой завершения работы.

'''Тесты поддерживаются в *UNIX операционных системах.'''

=== Получение информации о исходном коде ===

Получение информации о исходном коде выполняется автоматически с помощью скрипта, который проходит через все модули и получая от них необходимые. Эти данные хранятся в документе XML ('' / application / vendors/ unit_tester / unit_testing_config.xml'').

== Установка тестов ==

Установка необходимых библиотек:

v Ubuntu/Debianu:

sudo apt-get install curl perl libxml-writer-perl libxml-dom-perl

Fedora:

sudo yum install curl perl perl-XML-Writer perl-XML-DOM php-xml

'''Возможности:'''

cd /var/www/freenetis
chmod +x ./application/vendors/unit_tester/tester.sh

'''Предотвращение отправки e-mail/SMS т.д.:'''

Do config.php přidejte:

$config['unit_tester'] = TRUE;

== Выполнение тестов ==

'' 'Внимание: Тесты возможны только на локальном сервере разработки!'''

cd / var / www / freenetis / application / vendors / unit_tester
. / tester.sh <URL> <LOGIN_NAME> <PASSWORD>

'' Примечание: время работы всех тестов на Intel Core i5 2,53 ГГц с Ubuntu 11.04 составляет около четырех минут''.

'''Пример с аргументами'''

. / Tester.sh-O http://localhost/freenetis Админ 123456

=== Аргументы тестового скрипта ===

$. / Tester.sh - помощь
Скрипт для тестирования FreenetIS
ИСПОЛЬЗОВАНИЕ: tester.sh [параметры] URL Имя пользователя Пароль

Опции:
-О, --open-browser Открыть браузер с ошибками моделей или помощников
автоматически, после обнаружения ошибок.
-S, --skip-syntax Пропустить проверку синтаксиса всех файлов
-M, --skip-models Пропустить тест моделей
-H, --skip-helpers Пропустить тест помощников
-C, --skip-controllers Пропустить тест контроллеров
-E, --enable-stats Включить статистику и тесты

== Редактирование проверяемой информации ==

Автоматически сгенерированных значений теста недостаточно для тестирования, поэтому уместно добавить некоторую дополнительную информацию.

Например, определите модель в файле конфигурации, найдите соответствующие объекты (как заголовок и имена атрибутов).

'' 'Модель генерируется автоматически:'''

<MODEL name="test">
<method name="testovaci_funkce" autogenerate="on">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</ attributes>
<values>
<input>
value = "" /> <параметр
value = "Array ()" /> <параметр
</input>
</ values>
</ Method>
</ model>

Очень важным атрибутом метода является '''автоформирование'''. Если вы вносите изменения в методе и и устанавливаете их в '''off''' то при запуске тестирования изменения игнорируются.

Тег'''ввод''' можно рассматривать как набор тестовых значений метода.

'''Если вы не хотите, что метод был протестирован вообще (обычно это методы, которые зависят от объектов или вставки данных в базу данных), это может быть достигнуто следующим образом:'''

<model name="test">
<method name="testovaci_funkce" autogenerate="off">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</attributes>
<values>
</values>
</method>
</model>

'''Идеальные тестовые данные (попытка вставить пустые или бессмысленные значения) для нашей тестовой модели может выглядеть следующим образом:'''

<model name="test">
<method name="testovaci_funkce" autogenerate="off">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</attributes>
<values>
<input>
<param value="" />
<param value="" />
</input>
<input>
<param value="" />
<param value="array()" />
</input>
<input>
<param value="1" />
<param value="array('id' => '1')" />
</input>
<input>
<param value="abd'se$#@`" />
<param value="abd'se$#@`" />
</input>
<input>
<param value="1" />
<param value="array('id' => '1sef%se@š`', 'Ijnfsief' => 'se2', 'sef$a;!')" />
</input>
</values>
</method>
</model>

=== Дополнительные возможности для контроллеров ===

Контроллеры могут также отправлять данные с помощью POST и HTTP GET, только для проверки входных параметров добавьте параметры в виде:

<param name="post_name" type="post" value="hodnota" />
<param name="get_name" type="get" value="hodnota" />

Работа редактирования испытания действия документа ===

После каждого изменения файла конфигурации, вы должны проверить его корректность с помощью прилагаемого DTD (''/application/vendors/unit_tester/unit_testing_config.xml''), так как сам тест позволяет допустимые конфигурации!

В Netbeans IDE проверка выполняется выбором конфигурационного файла и запуском через контекстное меню проверки XML.

== Статистика и критерии ==

Тесты являются инструментом для анализа моделей и контроллеров. Их можно включить с помощью параметра <code>-e</code>.

Результаты тестов модели отобража.тся в выходноv HTML файл, наряду с тестами.

Результаты для контроллеров сохраняются в файле <code>curl/cstats</code>, который состоит из четырех столбцов, разделенных табуляцией.

* Первый столбец содержит информацию о времени контроллера в секундах.
* Второй столбец показывает потребление памяти в МБ для реализации.
* Третий столбец - URL запроса.
* Четвертый включает HTTP POST контроллера.

'' 'Пример: запрос о 10 наибольших потреблений памяти:'''

cat curl/cstats | cut -f 1,2,3 | sort -n -r -k 2,2 | head -n 10

'' Примечание: В данном руководстве рассматривается путь к FreenetIS предусмотренный в [[Установка FreenetIS]]''

Automatické testování

2014-06-07T14:23:50Z

Sivosha:

[[en:Automatic testing]]
[[ru:Автоматическое тестирование]]

Automatické testování slouží jako zpětná kontrola provedených akcí vývojáře.

== Architektura testů ==

Testy jsou zcela automatizované (programátor nemusí testy programovat, ale jen dodávat data k jejich testovaní) a automaticky přizpůsobitelně změnám ve zdrojových kódech.

Testy umožňují kontrolovat '''modely''', '''helpery''' a '''controllery''', ostatní části systému jsou kontrolovány pouze na jejich syntaktickou správnost.

Testy oproti unit testům neporovnávají výsledné hodnoty daných funkcí ale pouze ověřují zda-li neskončil běh chybou.

'''Testy jsou podporovány na *unix operačních systémech.'''

=== Načtení informací o zdrojových kódech ===

Načtení informací o zdrojových kódech probíhá automaticky pomocí skriptu, který prochází všechny testované subjekty a získává z nich data nutná k volání rutin subjektů. Tyto data jsou ukládána do XML dokumentu (''/application/vendors/unit_tester/unit_testing_config.xml'').

== Instalace testů ==

Instalace potřebných knihoven:

v Ubuntu/Debianu:

sudo apt-get install curl perl libxml-writer-perl libxml-dom-perl

ve Fedoře:

sudo yum install curl perl perl-XML-Writer perl-XML-DOM php-xml

'''Přidělení práv:'''

cd /var/www/freenetis
chmod +x ./application/vendors/unit_tester/tester.sh

'''Zamezení posílání e-mailů/SMS apod.:'''

Do config.php přidejte:

$config['unit_tester'] = TRUE;

== Spuštění testů ==

'''Upozornění: Testy spouštějte pouze na lokálním vývojovém serveru!'''

cd /var/www/freenetis/application/vendors/unit_tester
./tester.sh <URL> <LOGIN_NAME> <PASSWORD>

''poznámka: Doba běhu všech testů na Intel Core i5 2.53GHz s Ubuntu 11.04 je cca 4 minuty.''

'''Příklad s argumenty:'''

./tester.sh -o http://localhost/freenetis admin 123456

=== Argumenty testovacího skriptu ===

$ ./tester.sh --help
Script for testing FreenetIS
USAGE: tester.sh [options] URL username password

Options:
-o, --open-browser Opens browser with models or helpers errors
automatically, after error detection.
-s, --skip-syntax Skip syntax check of all files
-m, --skip-models Skip test of models
-h, --skip-helpers Skip test of helpers
-c, --skip-controllers Skip test of controllers
-e, --enable-stats Turn on statistics and benchmarks

== Úprava testovaných informací ==

Automaticky vygenerované testovací hodnoty nejsou pro testování dostatečné, proto je vhodné doplnit některé další hodnoty.

Postupy uvedeme na příkladu modelu, v konfiguračním souboru nalezněte příslušný subjekt (dle názvu tagu a atributu jména).

'''Model po automatickém vygenerování:'''

<model name="test">
<method name="testovaci_funkce" autogenerate="on">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</attributes>
<values>
<input>
<param value="" />
<param value="array()" />
</input>
</values>
</method>
</model>

Velmi důležitý je atribut metody '''autogenerate''', pokud provedete změny v metodě a nenastavíte jej na hodnotu '''off''' změny se při spuštění testování zahodí.

Tag '''input''' lze chápat jako jednu sadu testovaných hodnot dané metody.

'''Pokud si nepřejete aby metoda byla testována vůbec (časté u metod, které jsou závislé na objektech, nebo vkládají data do databáze), lze toho docílit takto:'''

<model name="test">
<method name="testovaci_funkce" autogenerate="off">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</attributes>
<values>
</values>
</method>
</model>

'''Ideální testovací data (snažíme se vkládat i nesmyslné a prázné hodnoty) pro náš testovací model mohou vypadat takto:'''

<model name="test">
<method name="testovaci_funkce" autogenerate="off">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</attributes>
<values>
<input>
<param value="" />
<param value="" />
</input>
<input>
<param value="" />
<param value="array()" />
</input>
<input>
<param value="1" />
<param value="array('id' => '1')" />
</input>
<input>
<param value="abd'se$#@`" />
<param value="abd'se$#@`" />
</input>
<input>
<param value="1" />
<param value="array('id' => '1sef%se@š`', 'Ijnfsief' => 'se2', 'sef$a;!')" />
</input>
</values>
</method>
</model>

=== Dodatečné vlastnosti pro controllery ===

Pro controllery lze posílat i data pomocí POST a GET HTTP akce, stačí do vstupního parametrů testu přidat parametry ve tvaru:

<param name="post_name" type="post" value="hodnota" />
<param name="get_name" type="get" value="hodnota" />

=== Po-editační testovaní validity dokumentu ===

Po každé editaci konfiguračního souboru je vhodné zkontrolovat jeho validitu pomocí dodaného DTD (''/application/vendors/unit_tester/unit_testing_config.xml''), jelikož samotný test počítá s validní konfigurací!

V IDE Netbeans kontrolu validity provedete pomocí označení konfiguračního souboru a následného vyvolání jeho kontextového menu a položky Validate XML.

== Statistiky a benchmarky ==

Součástí testů jsou i nástroje pro benchmarky modelů a controllerů. Lze je zapnout pomocí parametru <code>-e</code>.

Výsledky benchmarků u modelů je zobrazováno ve výstupním HTML souboru společně s testy.

Výsledky u controllerů jsou ukládány do souboru <code>curl/cstats</code>, který má čtyři sloupce oddělené tabulátorem.

* První slopec obsahuje informaci o době provádění controlleru v sekundách.
* Druhý sloupec obsahuje spotřebu paměti v MB pro dané provádění.
* Třetí sloupec je URL požadavku.
* Čtvrtý obsahuje hodnoty HTTP POST odeslané controlleru.

''' Příklad výpsání 10 požadávků s největší spotřebou paměti: '''

cat curl/cstats | cut -f 1,2,3 | sort -n -r -k 2,2 | head -n 10

''Poznámka: V celém návodu je uvažována cesta k FreenetISu odvozená z [[Instalace FreenetIS]]''

Automatic testing

2014-06-07T14:23:41Z

Sivosha:

[[cs:Automatické testování]]
[[ru:Автоматическое тестирование]]

Automated testing is used as feedback control of your actions developer.

== Architecture tests ==

The tests are fully automated (You do not need testing program, but only deliver data to their testing) and automatically customizable changes in the source code.

Tests allow you to check'''models''','''helpers''' and'''controllers''', other parts of the system are checked only on their syntactic correctness.

Tests over unit tests do not compare the resulting values of the function but only verify whether finished running error.

'''Tests are supported on *UNIX operating systems.'''

=== Retrieving information about the source code ===

Retrieving information about the source code is done automatically using a script that goes through all the subjects and obtained from them the necessary data to the calling routine subjects. These data are stored in a XML document ('' / application / vendors / unit_tester / unit_testing_config.xml'').

== Installation tests ==

Installing the required libraries:

Ubuntu / Debian:

sudo apt-get install curl perl libxml-writer-perl libxml-dom-perl

Fedora:

sudo yum install curl perl perl-XML-Writer perl-XML-DOM php-xml

'' 'The possibilities:'''

cd / var / www / freenetis
chmod + x. / application / vendors / unit_tester / tester.sh

'' 'Preventing sending e-mail/SMS etc.:'''

Do config.php add:

$ config ['unit_tester'] = TRUE;

== Running tests ==

'' 'Warning: Test Run only on the local development server!'''

cd / var / www / freenetis / application / vendors / unit_tester
. / tester.sh <URL> <LOGIN_NAME> <PASSWORD>

'' Note: The running time of all tests on Intel Core i5 2.53GHz with Ubuntu 11.04 is about four minutes.''

'' 'Example with arguments'''

. / tester.sh-o http://localhost/freenetis admin 123456

=== Arguments test script ===

$. / Tester.sh - help
Script for testing FreenetIS
USAGE: tester.sh [options] URL username password

Options:
-o, - open-browser Opens browser with models or helpers errors
automatically, after error detection.
-s, - skip-syntax Skip syntax check of all files
-m, - skip-models Skip test of models
-h, - skip-helpers Skip test of helpers
-c, - skip-controllers Skip test of controllers
-e, - enable-stats Turn on statistics and benchmarks

== Editing tested information ==

Automatically generated test values are not sufficient for testing, so it is appropriate to add some additional value.

For example, indicate the model in the configuration file, find the relevant entity (as the title tag and attribute names).

'' 'Model been automatically generated:'''

<Model name="test">
<method name="testovaci_funkce" autogenerate="on">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</ attributes>
<values>
<input>
value="" /> <param
value="array()" /> <param
</ input>
</ values>
</ method>
</ model>

Very important is the attribute method'' 'autogenerate''' if you make changes in the method and made it to'' 'off''' changes when you start testing discarded.

Tag'' 'input''' can be understood as a set of test values of the method.

'' 'If you do not want that method has been tested at all (common with methods that depend on objects, or insert data into the database), this can be achieved as follows:'''

<model name="test">
<method name="testovaci_funkce" autogenerate="off">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</attributes>
<values>
</values>
</method>
</model>

'' 'Ideal test data (trying to insert an empty and meaningless and value) for our test model might look like this:'''

<model name="test">
<method name="testovaci_funkce" autogenerate="off">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</attributes>
<values>
<input>
<param value="" />
<param value="" />
</input>
<input>
<param value="" />
<param value="array()" />
</input>
<input>
<param value="1" />
<param value="array('id' => '1')" />
</input>
<input>
<param value="abd'se$#@`" />
<param value="abd'se$#@`" />
</input>
<input>
<param value="1" />
<param value="array('id' => '1sef%se@š`', 'Ijnfsief' => 'se2', 'sef$a;!')" />
</input>
</values>
</method>
</model>

=== Additional features for controllers ===

The controllers can also send data using POST and HTTP GET action, just to test the input parameters add parameters in the form:

<param name="post_name" type="post" value="hodnota" />
<param name="get_name" type="get" value="hodnota" />

=== After-editing tested validity of the document ===

After each editing the configuration file, you should check its validity using the supplied DTD ('' / application / vendors / unit_tester / unit_testing_config.xml'') as the test itself allows for valid configurations!

In Netbeans IDE validity checking done by marking the configuration file and then invoke the context menu items and Validate XML.

== Statistics and benchmarks ==

The tests are tools for benchmarking models and controllers. They can be turned on using the parameter <code>-e </ code>.

The results of benchmark models is displayed in the output HTML file, along with the tests.

Results for the controllers are stored in a file <code> curl / cstats </ code>, which has four columns separated by a tab.

* The first column contains the information about the time of the controller in seconds.
* The second column shows memory consumption in MB for the implementation.
* The third column is the URL request.
* The fourth includes the HTTP POST sent controller.

'''Example hits the 10 requirements with the largest memory consumption:'''

cat curl / cstats | cut-f 1,2,3 | sort-n-r-k 2,2 | head-n 10

'' Note: Throughout this manual is considered the path to FreenetIS derived from [[Installation FreenetIS]]''

Automatická změna struktury databáze

2014-06-07T14:18:29Z

Sivosha:

[[en:Automatic change of database structure]]
[[ru:Автоматическая смена структуры базы данных]]

FreenetIS obsahuje mechanismus pro automatickou změnu struktury databáze. Tyto změny jsou provedeny po spuštění FreenetISu (po otevření v prohlížeči) po jeho aktualizaci (zde nezáleží, zda-li se jedná o aktualizace skrze balíčkovací systém, nebo z vývojářského repozitáře). Provedené změny nelze zrušit, což znamená, že snížení verze (downgrade) FreenetISu není možné (tento jev lze samozřejmě odstranit manuální změnou databáze ze zálohy, při které ovšem nejsme schopni zaručit správnost výsledného stavu sytému).

Mechanismus pro aktualizaci je úzce spjat s [http://wiki.freenetis.org/index.php/Verzování_FreenetISu verzováním FreenetISu]. Ve složce '''/db_upgrades''' se nachází soubory se změnami pro jednotlivé verze FreenetISu. Jména souborů jsou ve formátu '''upgrade_sql_VERZE.php''', kde '''VERZE''' je nahrazena verzí FreenetISu. Soubory samotné musí obsahovat položku pole '''$upgrade_sql''' s indexem daným verzí FreenetISu. Tato položka obsahuje pole SQL příkazů, které jsou postupně spuštěny. Dále může obsahovat PHP funkce spouštěné před a po provedení SQL příkazů, které jsou používané pokud např. nelze data databáze převést mezi jednotlivými verzemi přímo pomocí SQL příkazů. Obě funkce mohou obsahovat libovolné PHP příkazy a musí vracet pravdivostní hodnotu (boolean).

Příklad souboru se změnami:

<?php defined('SYSPATH') or die('No direct script access.');
/*
* This file is part of open source system FreenetIS
* and it is released under GPLv3 licence.
*
* More info about licence can be found:
* http://www.gnu.org/licenses/gpl-3.0.html
*
* More info about project can be found:
* http://www.freenetis.org/
*
*/

/** This upgrade is equal to one in 1.0.0~beta2 developer revision */
$upgrade_equal_to['1.0.0~rc1'] = '1.0.0~beta2';

function upgrade_1_0_0_rc1_before()
{
echo "Some PHP code triggered before processing of all SQL commands"
return TRUE;
}

$upgrade_sql['1.0.0~rc1'] = array
(
"ALTER TABLE `ifaces` CHANGE `device_id` `device_id` INT( 11 ) NOT NULL",

"UPDATE ifaces i, wireless_ifaces wi
SET wireless_mode = wmode, wireless_antenna = antenna
WHERE wi.iface_id = i.id",

);

function upgrade_1_0_0_rc1_after()
{
echo "Some PHP code triggered after processing of all SQL commands"
return TRUE;
}

Pokud některý z SQL příkazů vyvolá chybu, popřípadě některá funkce vrátí FALSE, je provádění ukončeno a chyba zobrazena uživateli. Při tomto stavu je FreeneIS nefunkční, pokud takový stav nastane, doporučujeme kontaktovat vývojáře a ze zálohy si obnovit poslední fungující verzi databáze (společně se snížením verze FreenetISu).

=== Aktuální stav databáze ===

Stav databáze je uchováván v databázové tabulce config v poli '''db_schema_version''', které obsahuje aktuální verzi databáze. Pokud je databáze v chybovém stavu, nepovedený krok je zaznamenán v poli '''upgrade_midpoint_error'''. Tato hodnota umožňuje opětovné provedení aktualizace od chybné položky, proto při chybě stačí opravit chybnou položku a znovu spustit FreenetIS v prohlížeči.

=== Relace mezi změnami ===

V příkladu se ještě nachází položka '''$upgrade_equal_to['1.0.0~rc1']''', která je používaná pro vývojářské účely. ''(Při mergi změn z větve do trunku/testingu lze hodnotu tohoto pole vyplnit vývojovou verzí, která obsahovala stejnou sadu příkazů (a funkcí). Pokud se databáze nachází ve stavu vývojové verze a je jí nabídnuta verze, která pomocí tohoto pole odkazuje na vývojovou verzi. Je tato verze přeskočena. '''Soubor se změnami odkazované verze je v commitu odstraněn!!''')''

== Přechod ze starší verze mechanismu ==

Starší verze FreeneISu (vývojová verze před vydáním verze 1.0.0) obsahovala starší verzi mechanismu (založenou na SVN revizi). Pokud provádíte čistou instalaci nad novou databází, tento problém se Vás netýká.

Přechod mezi tímto mechanismem lze provest pomocí několika příkazů svn.

1) Otevřte terminál (příkazovou řádku) a přesuňte se do adresáře s instalací FreenetISu, typicky:

$ cd /var/www/freenetis

2) Přejděte na poslední revizi s upgradem databáze před vydání verze 1.0.0

$ svn -r 1559 up

3) Spusťte v prohlížeči FreenetIS a pokud jsou úpravy úspěšně provedeny přejděte na další krok.

4) Přejděte na nejnovější verzi FreenetISu. Nový mechanismus již automaticky rozpozná verzi databáze (starý mechanismus) a provede přechod.

$ svn up

'''POSLEDNÍ KROK JE OVŠEM NEDOPORUČOVANÝ, JELIKOŽ OD VYDÁNÍ VERZE 1.0.0 SE UPUSTILO OD DISTRIBUCE FREENETISU PROMOCÍ SUBVERSION, PROTO POSLEDNÍ KROK DOPORUČUJEME NAHRADIT PŘEINSTALACÍ FREENETISU Z BALÍČKOVACÍCH SYSTÉMU (data samozřejmě zůstanou zachována, jelikož i při přeinstalaci můžete zvolit Vaši původní databázi).'''

== Bezpečna změna databáze do verze 1.0.0 ==

Do vezre 1.0.0 neobsahoval FreenetIS bezpečnostní pojistky pro výcečetné spuštění upgradu. Tento problém nastavá v případě, že více lidí/služeb přistupují na FreenetIS při upgradu databáze. Následujícím postupem se vyhnete problému při upgradu databáze: ('''Tento návod se týká FreenetISu do verze 1.0.0, od této verze (včetně) je správný chod zaručen automaticky.''')

1) Vypneme všechny služby přistupující k FreenetISu (CRON, přesměrování. QoS, monitoring, ...). Např. CRON na Debianu se vypíná následovně:

/etc/init.d/cron stop

2) Vypneme apache server

/etc/init.d/apache2 stop

3) Provedeme upgrade

wget http://<cesta k vašemu FreenetISu>

4) Spustíme znovu apache a služby

/etc/init.d/apache2 start
/etc/init.d/cron start
...

Автоматическая смена структуры базы данных

2014-06-07T14:18:00Z

Sivosha: Založena nová stránka: cs:Automatická změna struktury databáze en:Automatic change of database structure FreenetIS включает в себя механизм автоматичес...

[[cs:Automatická změna struktury databáze]]
[[en:Automatic change of database structure]]

FreenetIS включает в себя механизм автоматического изменения структуры базы данных. Эти изменения выполняются после старта FreenetIS (после открытия браузера), после обновления ( здесь это не имеет значения , происходит ли это обновление через систему пакетов , или через развитие хранилища ) . Изменения не могут быть отменены , а это значит , что понижение версии FreenetIS не возможно ( конечно, это может быть выполнено вручную через восстановление базы данных из резервной копии, однако , мы не можем гарантироватькорректность конечного состояния системы ) .

Механизм обновления тесно связан с [ http://wiki.freenetis.org/index.php/Verzování_FreenetIS версий FreenetIS ] . В папке '' ' / db_upgrades ''' находится файл с изменениями каждой версии FreenetIS . Имена файлов в формате '' ' upgrade_sql_VERZE.php '' ', где '''VERZE''' заменяется версией FreenetIS . Сам файл должен содержатьполе '''$ upgrade_sql ''' с индексом версии данного FreenetIS. Этот пункт содержит массив SQL операторов, которые выполняются последовательно. Он может также содержать PHP функции, которые выполняются до и после выполнения SQL- команд, которые используются, например, если данные не могут быть переданы между разными версиями непосредственно с помощью SQL команд. Обе функции могут содержать произвольные команды PHP и должна возвращать логическое значение (Boolean) .

Исходный файл изменений:

<PHP определена ('SYSPATH') или умереть ("Нет прямого доступа скрипта. ')?;
/ *
* Этот файл является частью открытого кода FreenetIS
* И он выпущен под лицензией GPLv3.
*
* Более подробную информацию о лицензии можно найти:
* http://www.gnu.org/licenses/gpl-3.0.html
*
* Более подробную информацию о проекте можно найти:
* http://www.freenetis.org/
*
* /

/** This upgrade is equal to one in 1.0.0~beta2 developer revision */
$upgrade_equal_to['1.0.0~rc1'] = '1.0.0~beta2';

function upgrade_1_0_0_rc1_before()
{
echo "Some PHP code triggered before processing of all SQL commands"
return TRUE;
}

$upgrade_sql['1.0.0~rc1'] = array
(
"ALTER TABLE `ifaces` CHANGE `device_id` `device_id` INT( 11 ) NOT NULL",

"UPDATE ifaces i, wireless_ifaces wi
SET wireless_mode = wmode, wireless_antenna = antenna
WHERE wi.iface_id = i.id",

);

function upgrade_1_0_0_rc1_after()
{
echo "Some PHP code triggered after processing of all SQL commands"
return TRUE;
}

=== Связь между изменениями ===

Если любой из оператор SQL генерирует ошибку или некоторая функция возвращает FALSE, выполнение завершается, и ошибка отображается для пользователя. Когда возникает такая ситуация и FreeneIS выйходит из строя, мы рекомендуем вам обратиться к разработчику для восстановления последней рабочей версии базы данных (наряду с снижением версии FreenetIS).

=== Текущее состояние базы данных ===

Текущее состояние базы данных хранится в таблице базы данных в поле '''db_schema_version''', которое содержит текущую версию базы данных. Если база данных находится в состоянии ошибки, этот шаг записывается в '''upgrade_midpoint_error'''. Это значение позволяет повторно выполнить обновление с этого шага, таким образом ошибка исправляется и повторно запускается браузера FreenetIS

=== Связь между изменениями ===

В этом примере есть пункт'' '$ upgrade_equal_to ['1 .0.0 ~ rc1']'' ', который используется для целей разработки. '' (При слиянии изменений разных частей значение этого поля может заполнено разрабатываемой версией, которая содержит тот же набор команд (и функции). Если база данных находится в состоянии разработки и предлагается версия которая использует это поле относительно версии разработки. Пропустите эту версию. '' 'Файл с изменениями этой версии после выполнения операции будет удален!''')''

== Переход от старых версий ==

Старые версии FreeneIS (до версии 1.0.0) включают в себя более раннюю версию механизма (на основе пересмотра SVN) . Если вы выполняете чистую установку новой базы данных , эта проблема вас не касается .

Переход между этот механизм может быть выполнена с использованием нескольких SVN команд.

1) Откройте терминал (командная строка) и перейдите в каталог с установкой FreenetISu , обычно :

$ Cd / Var / WWW / freenetis

2) Перейдите к последней редакции , чтобы обновить базу данных до выхода версии 1.0.0

$ Svn up-r 1559

3) Запуститебраузер FreenetIS и если корректировка осуществляется успешно перейдите к следующему шагу.

4) Перейти к последней версии FreenetIS . Новый механизм автоматически обнаруживает версию базы данных (старый тип) и осуществляет переход .

$ Svn up

Последний шаг однако не рекомендуется потому что начиная с релиза 1.0.0 выпала градация субверсий FreenetIS. Поэтому рекомендуется переустановка коробочной версии системы (Конечно, данные будут сохранены потому что даже при переустановке, вы можете выбрать исходную базу данных)

== Безопасное изменение версии до 1.0.0 ==

До версии FreenetIS 1.0.0 не обеспечивается безопасное одновременное внесение изменений. Эта проблема возникает, когда несколько людей / услуг FreenetIS осуществляют доступ к обновлению базы данных. Выполните следующие действия, чтобы избежать проблем при обновлении базы данных: ('' '. Эта инструкция FreenetIS применима до версии 1.0.0, так как с этой версии (в комплекте) автоматически гарантируется правильная работа''')

1) Выключите все услуги доступа к FreenetIS (CRON, redirect. QoS, monitoring, ...). Например CRON на Debian следующим образом:

/ etc / init.d / cron stop

2) Выключите сервер apache

/ etc/init.d/apache2 stop

3) Выполнение обновления

wget http:// <path_to_mount_directory> ваш FreenetIS>

4) Перезапустите Apache и услуги

/ etc/init.d/apache2 start
/ etc / init.d / cron start

Automatic change of database structure

2014-06-07T14:15:16Z

Sivosha:

[[cs:Automatická změna struktury databáze]]
[[ru:Автоматическая смена структуры базы данных]]

FreenetIS includes a mechanism for automatically changing the structure of the database. These changes are made after the start FreenetIS (after opening the browser ) after the update ( here it does not matter whether it is an update through the package system , or from the development repository ) . The changes can not be canceled , which means that the downgrade FreenetIS not possible ( of course, this phenomenon can be removed manually changing the database from a backup , in which, however, we can not guarantee the correctness of the final state of the system) .

The mechanism for updating is closely related to [ http://wiki.freenetis.org/index.php/Verzování_FreenetIS versioning FreenetIS ] . In the folder '' '/ db_upgrades ''' is a file with the changes for each version FreenetIS . The file names are in the format '' ' upgrade_sql_VERZE.php ''' , where '' 'Version ''' is replaced by version FreenetIS . File itself must contain an entry field '' '$ upgrade_sql '' ' s index of a given version FreenetIS . This item contains an array of SQL statements that are executed sequentially . It may also contain PHP functions that run before and after the execution of SQL commands that are used for example if the data can not be transferred between different versions of directly using SQL commands. Both functions can contain arbitrary PHP commands and must return a boolean value ( boolean) .

Example file changes:

<?php defined('SYSPATH') or die('No direct script access.');
/*
* This file is part of open source system FreenetIS
* and it is released under GPLv3 licence.
*
* More info about licence can be found:
* http://www.gnu.org/licenses/gpl-3.0.html
*
* More info about project can be found:
* http://www.freenetis.org/
*
*/

/** This upgrade is equal to one in 1.0.0~beta2 developer revision */
$upgrade_equal_to['1.0.0~rc1'] = '1.0.0~beta2';

function upgrade_1_0_0_rc1_before()
{
echo "Some PHP code triggered before processing of all SQL commands"
return TRUE;
}

$upgrade_sql['1.0.0~rc1'] = array
(
"ALTER TABLE `ifaces` CHANGE `device_id` `device_id` INT( 11 ) NOT NULL",

"UPDATE ifaces i, wireless_ifaces wi
SET wireless_mode = wmode, wireless_antenna = antenna
WHERE wi.iface_id = i.id",

);

function upgrade_1_0_0_rc1_after()
{
echo "Some PHP code triggered after processing of all SQL commands"
return TRUE;
}

=== The current state of the database ===

State database is stored in a database table in the field ''' db_schema_version ''' , which contains the current version of the database . If the database is in an error state , foiled step is recorded in the ''' upgrade_midpoint_error ''' . This value allows you to re-perform the update from the wrong items , so the errors just correct a wrong entry and re-run FreenetIS browser .

=== Relation between changes ===

In the example, there is the item '''$ upgrade_equal_to [ '1 .0.0 ~ rc1 '] ''' , which is used for development purposes . '' ( When you merge changes from branch to trunk / testing the value of this field can fill development version , which contained the same set of commands ( and functions) . If the database is in a state of development versions and is offered a version that uses this field refers to the development version . Skipped this version . ''' File with changes of the referenced version after commit will be deleted ! ''' ) ''

If any of the SQL statement generates an error, or some function returns FALSE , the implementation is completed and the error displayed to the user . When such a situation occurs and FreeneIS become inoperable, we recommend you contact the developer of backup and restore the last working version of the database (along with a reduction FreenetISu version ) .

== Transition from older versions ==

Older versions FreeneIS (development version prior to version 1.0.0 ) includes an earlier version of the mechanism ( based on SVN revision ) . If you perform a clean installation of a new database , this problem does not concern you .

The transition between this mechanism can be accomplished using several commands svn .

1 ) Open a terminal ( command prompt ) and navigate to the directory with the installation FreenetISu , typically :

$ Cd / var / www / freenetis

2 ) Go to the latest revision to upgrade the database before the release of version 1.0.0

$ Svn up -r 1559

3) Start the browser FreenetIS and if adjustments are carried out successfully go to the next step .

4 ) Go to the latest version FreenetISu . A new mechanism has been automatically detects the version of the database (old type) and makes a transition .

$ Svn up

''' The last step , however, is advised against because since the release 1.0.0 has departed from the pattern FREENETIS graduation Subversion , SO LAST STEP recommends replacing reinstalling FREENETIS of package systems (data , of course, remain the same , as well as when you choose to reinstall your original database ).'''

== Safely change the database to version 1.0.0 ==

Do not include to FreenetIS 1.0.0 version available safeguards for multiple start the upgrade. This problem occurs when multiple people / services FreenetIS access to the database upgrade. Follow these steps to avoid problems when upgrading the database: ('' 'This instruction applies FreenetISu to version 1.0.0, since this version (included) is automatically guarantee correct operation.''')

1) Turn off all services accessing the FreenetISu (CRON, redirect. QoS, monitoring, ...). Eg. CRON on Debian off as follows:

/ etc / init.d / cron stop

2) Turn off the apache server

/ etc/init.d/apache2 stop

3) Perform the upgrade

wget http:// <path_to_mount_directory> your FreenetIS>

4) Restart the apache and services

/ etc/init.d/apache2 start
/ etc / init.d / cron start

Системный администратор - установки пользовательской роли казначея

2014-06-07T14:05:01Z

Sivosha: Založena nová stránka: cs: SystemAdmin - nastavení Uživatelská role Pokladník en: System Admin - User role treasurer setting == Администрация - Права доступа...

[[cs: SystemAdmin - nastavení Uživatelská role Pokladník]]
[[en: System Admin - User role treasurer setting]]

== Администрация - Права доступа - Добавить новое правило ==

Описание, например'' Казначей может видеть / добавлять / изменять все финансовые документы''

'''ACO:'''

Редактировать все записи

Редактировать собственные записи

Добавить все записи

Добавить свои собственные записи

Просмотреть все записи

Смотреть собственные записи

'' 'ARO:'''

казначей

'''AXO:'''

96 Accounts_Controller accounts Счета

135 Accounts_Controller bank_accounts Банковские счета

163 Accounts_Controller bank_statements Банковская отчетность

134 Accounts_Controller bank_transfers Банковские переводы

55 Accounts_Controller invoices Счета

95 Accounts_Controller transfers Переводы

136 Accounts_Controller unidentified_transfers Неидентифицированны переводы

106 Members_Controller currentcredit Текущий кредит

107 Members_Controller en_fee первоначальный взнос

108 Members_Controller en_fee_left Оставшаяся входная оплата
== Администрирование - Управление пользовательскими группами - Добавить новую группу ==

Назовите ее “Казначей”

Родители: “Все члены”

сохраните

В пользовательских группах выберите строку Кассир, кликните “Редактировать” и выберите пользователей которые будут казначеями, перемещая стрелку вправо и сохраняя.

130 Settings_Controller fees Платежи

Сохранить

Установка из исходного кода

2013-12-10T13:06:02Z

Sivosha: Založena nová stránka: cs:Instalace ze zdrojových kódů en: Instalation from source code '''Это руководство предназначено для разработчиков F...

[[cs:Instalace ze zdrojových kódů]]
[[en: Instalation from source code]]

'''Это руководство предназначено для разработчиков FreenetIS, в целях распространения доступен [http://wiki.freenetis.org/index.php/Instalace установка системы управления].'''

FreenetIS может работать на любом сервере (включая Windows), но рекомендуемая платформа Linux.

= Linux =

В этих инструкциях предполагается использование Debian. Для других дистрибутивов процедура будет аналогичной.

== Подготовка ==

Установка PHP, Apache, MySQL и PHPMyAdmin. Вы должны войти в систему с правами администратора.
apt-get install apache2 php5 php5-mysql php5-curl mysql-server phpmyadmin

'''Поддерживаемые версии'''

*'''PHP''' версии 5.1.2 и выше
*'''MySQL''' версии 5.1.0 и выше

=== Язык ===
Для правильной функции сравнения строк в PHP должен быть установлен чешский UTF-8 локали. Итак:
dpkg-reconfigure locales

Выберите:

en_US.UTF-8
en_US.UTF-8

и перезапустить Apache:

apache2ctl graceful

=== Apache ===

Для корректной работы Apache внесите изменения в конфигурационный файл для VirtualHost. Для Debian можно найти:
* Если у вас не была выполнена настройка то это файл
/ etc/apache2/sites-available/default
* Если у вас уже есть VirtualHost, то он, вероятно, быть сконфигурирован в других файлах в каталоге / etc/apache2/sites-available /

В этом файле, добавьте строки:

<VirtualHost *>
ServerAdmin webmaster@example.org
ServerName freenetis.example.org
DocumentRoot / Var / WWW / freenetis
<Directory /var/www/freenetis>
Options Indexes FollowSymLinks MultiViews
Order allow, deny
позвольте от всех
</ Directory>
</ VirtualHost>

где, конечно, вместо ServerAdmin, ServerName введите свои данные.

Наконец, перезапустить Apache командой:

/ Etc/init.d/apache2 restart

== Дополнительно: Включить mod_rewrite ==

Если он не включен, сделайте это:

a2enmod rewrite

В конфигурации виртуального хоста и Apache (точка пересечения), включите доступ к каталогу FreenetIS исправив конфигурационный файл с помощью Apache. Htaccess - Directory раздел, добавить директиву "AllowOverride All". Этот раздел должен конечном итоге выглядеть так:

<Directory /var/www/freenetis>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow, deny
allow from all
</ Directory>

Наконец, перезапустить Apache командой:

/ Etc/init.d/apache2 restart

=== MySQL ===

Для установки базы данных MySQL можно использовать многочисленные инструменты и процедуры. В любом случае вам нужно будет ввести имя пользователя и пароль для сервера MySQL. После установки, есть только один пользователь - root и пустой пароль.

dpkg-reconfigure mysql-server-VERSION

где VERSION номер версии сервера MySQL. В более новых версиях это обычно 5.1 для тех, кто старше 5.0.

====Использование phpMyAdmin====

[http://cs.wikipedia.org/wiki/PhpMyAdmin PhpMyAdmin] этосовременный инструментарий для управления MySQL через ВЭБ-интерфейс. После инсталяции доступен:

<nowiki> http://printer_ip_address/ server / phpMyAdmin / </ nowiki>

или если у вас локальный хост:

<nowiki> http://localhost/phpmyadmin/ </ nowiki>

Кликните Разрешения, затем Добавить Нового пользователя. Введите любое имя (рекомендуется freenetis). Выберите локальный компьютер (из соображений безопасности). Задайте сильный пароль, предпочтительно случайно сгенерированный (хороший пример случайного генератора паролей [http://www.converter.cz/passgen/pswdgen.php здесь]. Выберите “Создать базу данных с темже именем и дать полный доступ” и справа внизу нажмите Выполнить.

====Использование консоли====

Если не использовать PhpMyAdmin то можно создать базу данных вручную. Сначала необходимо залогиниться в MySQL с правами суперпользователя

mysql-u root-p

Затеми наберите команду

create database freenetis;
create user 'freenetis' @ 'localhost' IDENTIFIED BY 'password';
grant all on freenetis. * it 'freenetis' @ 'localhost';

==Загрузка==
===Загрузка с SVN===

Если у вас не установлен SVN клиент
apt-get install subversion

Теперь вы можете загрузить FreenetIS в каталог /var/www/freenetis (это наиболее стабильная версия, другие используются для разработуи и тестирования)

cd / var / www
svn checkout - username = username <nowiki> svn + ssh :/ / username@svn.code.sf.net / p / freenetis / code / freenetis / trunk freenetis </ nowiki>

Откройте доступ на запись в каталог freenetis/upload и создайте каталог для логов

cd / var / www / freenetis
chmod ugo + w. upload
mkdir-m 0777 logs

FreenetIS посоянно развивается. Команда для загрузки изменений:

cd / var / www / freenetis
svn update

(загружаются только измененные файлы)

===Фиксирующие логи===
Логи основной стабильной версии
[http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/trunk/kohana/?view=доступны здесь].

В настоящее время мы используем систему разработки паралельно несколькими ветвями (например тестирование и т.д.) и основной ветвью и обменом изменениями между ними. Поэтому количество ошибок меньше чем было раньше.

Итоговые логи для всех ветвей здесь
[http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/?view=log].

===Инсталяция===

Теперь если ввести в бравзере ваш адрес FreenetIS откроется стартовое окно инсталятора.

===Конфигурация===

Сначала инсталятор проинформирует вас, что необходимо создать файл config.php. Нажмите Следующий Шаг.

Теперь инсталятор предложит вам ввеести данные для доступа к серверу MySQL. Введите данные, которые вы использовали при подготовке MySQL и нажмите Отправить.

Если вы ввели правильную информацию, инсталятор проинформирует вас что конфигурация завершена. В противном случае сообщит, что не смог подключиться к базе данных и укажет вероятную причину проблемы.

После исправления ошибки нажмите Следующий Шаг.

====Дополнительно: Создание config.php вручную====

Если у вас нет доступа на запись в каталог, freenetis, программа установки сгенерирует код, который необходимо скопировать и сохранить в файле config.php в каталоге freenetis. '''Пока вы этого не сделаете, установка будет прекращена!'''

===Инсталяция===

Теперь перед вами появится форма с информацией о вашей ассоциации. После ее заполнения установка будет завершена.

====Дополнительно: Создание вручную Htaccess====

Если вы установили флажок Read URL и у вас нет доступа на запись в каталог freenetis, программа установки cгенерирetn код, который необходимо скопировать и сохранить в файле Htaccess в каталоге freenetis. '''Если вы этого не сделаете, ваша установка может не работать должным образом!'''

===Подключение планировщика===

FreenetIS имеет пользовательский планировщик для которого должен быть установлен Cron:

#FreenetIS scheduler
* * * * * root wget -O /dev/null http://<hostname>/cs/scheduler/run

Если вы используете SSL с несанкционированным или недействительным сертификатом, используйте:

#FreenetIS scheduler
* * * * * root wget -O /dev/null https://<hostname>/cs/scheduler/run --no-check-certificate

Instalation from source code

2013-12-10T13:05:33Z

Sivosha:

[[cs:Instalace ze zdrojových kódů]]
[[ru:Установка из исходного кода]]
'''This manual is intended for FreenetIS developers, for distribution purposes is available [http://wiki.freenetis.org/index.php/Instalace installation of the packaging system].'''

FreenetIS can run on any server (including Windows), but the recommended platform is Linux.

= Linux =

These instructions assume the use of the Debian distribution. For other distributions the procedure will be similar.

== Preparation==

Installing PHP, Apache, MySQL and phpMyAdmin. You need to be logged in as root.
apt-get install apache2 php5 php5-mysql php5-curl mysql-server phpmyadmin

'''Supported versions of the'''

*'''PHP''' version 5.1.2 and higher
*'''MySQL''' version 5.1.0 and higher

=== Locale ===
For proper comparison function Czech strings in PHP must be installed Czech UTF-8 locale. so:
dpkg-reconfigure locales

Select:

en_US.UTF-8
en_US.UTF-8

and restart apache:

apache2ctl graceful

=== Apache ===

For proper running Apache edit configuration file for virtualhost. For Debian it can be found at the following:
* If you have any virtualhost not been setup yet, this is the file / etc/apache2/sites-available/default
* If you already have a virtualhost, it will probably be configured in some other files in the / etc/apache2/sites-available /

In this file, add the following lines:

<VirtualHost *>
ServerAdmin webmaster@example.org
ServerName freenetis.example.org
DocumentRoot / var / www / freenetis
<Directory /var/www/freenetis>
Options Indexes FollowSymLinks MultiViews
Order allow, deny
allow from all
</ Directory>
</ VirtualHost>

where, of course, place ServerAdmin and ServerName enter your data.

Finally, restart Apache command:

/ etc/init.d/apache2 restart

== Optional: Enable mod_rewrite ==

If it is not enabled, enable it:

a2enmod rewrite

In the virtualhost configuration and Apache (the crossing point), enable the directory FreenetIS possibility of readjusting the configuration file using Apache. Htaccess - Directory section to add the directive "AllowOverride All". This section Directory should then end up looking like this:

<Directory /var/www/freenetis>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow, deny
allow from all
</ Directory>

Finally, restart Apache command:

/ etc/init.d/apache2 restart

=== MySQL ===

To set MySQL database can be used numerous tools and procedures. For each of them, but you will need a user name and password for your MySQL server. After installation, there is only one user - root and the password is blank. If you forget it, you change it using

dpkg-reconfigure mysql-server-VERSION

where version is the version number of the MySQL server. In newer versions it is usually 5.1 for those older then 5.0.

====Using phpMyAdmin====

[http://cs.wikipedia.org/wiki/PhpMyAdmin PhpMyAdmin] is an advanced tool to manage MySQL database via a web interface. After installation is available at

<nowiki> http://printer_ip_address/ server / phpMyAdmin / </ nowiki>

or if you are working on localhost as well as on

<nowiki> http://localhost/phpmyadmin/ </ nowiki>

Click Permissions, and then click Add New User. Username Enter any (recommended freenetis). Select the local computer (important for safety). Set a strong password, preferably randomly generated (a good example is the generator [http://www.converter.cz/passgen/pswdgen.php here]. Choose "Create a database of the same name and grant all privileges" and the bottom right click on Execute .

====Using the console====

You can create the database manually. You must first log in to the database, you are prompted for a password database superuser.

mysql-u root-p

After logging in mysql console then type the following commands:

create database freenetis;
create user 'freenetis' @ 'localhost' IDENTIFIED BY 'password';
grant all on freenetis. * it 'freenetis' @ 'localhost';

==download==
===Download from SVN===

If you do not have a SVN client, then
apt-get install subversion

Now you can download FreenetIS to the directory / var / www / freenetis (the trunk is the most stable version, another SVN is used for development and testing)

cd / var / www
svn checkout - username = username <nowiki> svn + ssh :/ / username@svn.code.sf.net / p / freenetis / code / freenetis / trunk freenetis </ nowiki>

Enable write to the folder freenetis, freenetis / upload and create a folder for logging freenetis / logs:

cd / var / www / freenetis
chmod ugo + w. upload
mkdir-m 0777 logs

FreenetIS is constantly evolving, you download the update command:

cd / var / www / freenetis
svn update

(which downloads only modified files)

===Commit log===

Log fixes stable version (trunk) is [http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/trunk/kohana/?view=log available here].

Currently, we use a system development through various branches (eg, testing, etc.) and the main branch (trunk) send a functioning changes, so the number of errors is lower than in the situation of only one development branch, as it was before.

Summary [http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/?view=log log commit to all branches here].

==installation==

Now would be selected by entering your address into the browser FreenetIS installer should appear welcoming.

===Configuration===

In the first part of the installer informs you that you need to create a configuration file config.php. Click Next Step.

Now the installer prompts you to enter information to access the MySQL server. Use the information that you have used in the preparation of MySQL and click Send.

If you entered the correct information, the installer informs you that the configuration has been completed. Otherwise notifies you that failed to connect to the database with suggestions for possible problems.

When you manage to correct these errors, click Next Step.

====Optional: Manually create config.php====

If you do not have write access to the directory freenetis, the installer will generate code to copy and save it as config.php in the directory freenetis. '''Until you do so, the installation will be discontinued!'''

===The installation===

Now before you would be appearing the installation form with information about your association. After completing the installation should be done.

==== Optional: Manually create. Htaccess ====

If you have checked the Read URL and you do not have write access to the directory freenetis, the installer will generate code to copy and save it as a. Htaccess file in the directory freenetis. '''If you do not, your installation may not work properly!'''

===Launching of "planning"===

FreenetIS has a custom scheduler that is needed zpouštět regularly from cron. Do cron add this line:

# FreenetIS scheduler
***** Root wget-O / dev / null http:// <hostname> / en / scheduler / run

If you are using SSL with unauthorized or invalid certificates, use:

# FreenetIS scheduler
***** Root wget-O / dev / null https:// <hostname> / en / scheduler / run - no-check-certificate

Instalace ze zdrojových kódů

2013-12-10T13:04:41Z

Sivosha:

[[en:Instalation from source code]]
[[ru:Установка из исходного кода]]

'''Tento návod je určen pro vývojáře FreenetISu, pro distribuční účely je k dispozici [http://wiki.freenetis.org/index.php/Instalace instalace z balíčkovacích sytémů].'''

FreenetIS můžete provozovat na jakémkoli serveru (včetně Windows), ale doporučená platforma je Linux.

=Linux=

Tento návod předpokládá použití distribuce Debian. U jiných distribucí bude postup podobný.

==Příprava==

Instalace PHP, Apache, MySQL a phpMyAdmina. Je potřeba být přihlášen jako root.
apt-get install apache2 php5 php5-mysql php5-curl mysql-server phpmyadmin

'''Podporované verze nástrojů'''

* '''PHP''' verze 5.1.2 a vyšší
* '''MySQL''' verze 5.1.0 a vyšší

===Locale===
Pro správnou funkci porovnání českých řetězců v PHP musíte mít nainstalované české UTF-8 locale. Takže:
dpkg-reconfigure locales

Vybrat:

cs_CZ.UTF-8
en_US.UTF-8

a restartovat apache:

apache2ctl graceful

===Apache===

Pro správný běh Apache upravte soubor s konfigurací virtualhost-a, který na Debianu najdete takto:
*pokud jste žádný virtualhost zatím nenastavovali, jedná se o soubor /etc/apache2/sites-available/default
*pokud už nějaký virtualhost máte, pak bude nejspíš nakonfigurovaný v některém dalších souboru v adresáři /etc/apache2/sites-available/

Do tohoto souboru přidejte následující řádky:

<VirtualHost *>
ServerAdmin webmaster@example.org
ServerName freenetis.example.org
DocumentRoot /var/www/freenetis
<Directory /var/www/freenetis>
Options Indexes FollowSymLinks MultiViews
Order allow,deny
allow from all
</Directory>
</VirtualHost>

kde samozřejmě místo ServerAdmin a ServerName zadejte vaše údaje.

Nakonec restartujte Apache příkazem:

/etc/init.d/apache2 restart

====Volitelné: Povolení mod_rewrite====

Pokud jej nemáte povolený, tak jej povolte:

a2enmod rewrite

V konfiguraci virtualhost-a Apache (z přecházející bodu), povolte pro adresář FreenetIS možnost přenastavování konfigurace Apache pomocí souboru .htaccess - do sekce Directory přidejte direktivu "AllowOverride All". Tato sekce Directory by pak měl nakonec vypadat asi takto:

<Directory /var/www/freenetis>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>

Nakonec restartujte Apache příkazem:

/etc/init.d/apache2 restart

===MySQL===

Pro nastavení MySQL databáze je možné použít nespočet nástrojů a postupů. Pro každý z nich ale budete potřebovat uživatelské jméno a heslo pro přihlášení k vašemu MySQL serveru. Po instalaci existuje pouze jediný uživatel - root a jeho heslo je prázdné. Pokud jej zapomenete, změníte ho pomocí

dpkg-reconfigure mysql-server-VERZE

kde VERZE označuje číslo verze MySQL serveru. U novějších verzích je to obvykle 5.1, u těch starších pak 5.0.

====Pomocí phpMyAdmin====

[http://cs.wikipedia.org/wiki/PhpMyAdmin PhpMyAdmin] je pokročilý nástroj pro správu MySQL databázi přes webové rozhraní. Po instalaci je dostupný na

<nowiki>http://IP adresa serveru/phpmyadmin/</nowiki>

nebo pokud pracujete na localhostu, tak i na

<nowiki>http://localhost/phpmyadmin/</nowiki>

Kliknětě na Oprávnění a pak na Přidat nového uživatele. Jméno uživatele zadejte libovolné (doporučeno freenetis). Počítač vyberte lokální (důležité z hlediska bezpečnosti). Heslo nastavte silné, pokud možno náhodně vygenerované (dobrý generátor je např [http://www.converter.cz/passgen/pswdgen.php zde]. Vyberte volbu "Vytvořit databázi stejného jména a přidělit všechna oprávnění" a vpravo dole klikněte na Proveď.

==== Pomocí konzole====

Phpmyadmin nemusíte využít, pak lze databázi vytvořit ručně. Nejprve je nutné se přihlásit do databáze, budete vyzváni na heslo databázového superuživatele.

mysql -u root -p

Po přihlášení v konzoli mysql pak napište tyto příkazy:

create database freenetis;
create user 'freenetis'@'localhost' identified by 'heslo';
grant all on freenetis.* to 'freenetis'@'localhost';

==Stažení==
===Stažení z SVN===

Pokud nemáte SVN klienta, pak
apt-get install subversion

teď si můžete FreenetIS stáhnout do adresáře /var/www/freenetis (v trunku je nejstabilnější verze, další SVN větve slouží pro vývoj a testování)

cd /var/www
svn checkout <nowiki>svn+ssh://svn.code.sf.net/p/freenetis/code/freenetis/trunk freenetis</nowiki>

Povolte zápis do složek freenetis, freenetis/upload a vytvořte složku pro logování freenetis/logs:

cd /var/www/freenetis
chmod ugo+w . upload
mkdir -m 0777 logs

FreenetIS se neustále vyvíjí, aktualizace si stáhnete příkazem:

cd /var/www/freenetis
svn update

(což stáhne pouze modifikované soubory)

===Commit log===

Log oprav stable verze (trunk) je [http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/trunk/kohana/?view=log dostupný zde].

V současné době již používáme systém vývoje pomocí různých větvích (např. testing a další) a do hlavní větve (trunk) posíláme jen fungující změny, takže počet chyb je nižší než v situaci pouze jedné vývojové větve, jako tomu bylo dříve.

Souhrnný [http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/?view=log log commitů do všech větví je zde].

==Instalace==

Nyní by se po zadání vámi zvolené adresy FreenetISu do prohlížeče měl objevit instalátor s uvítáním.

===Nastavení konfigurace===

V první části vás instalátor informuje, že je potřeba vytvořit soubor konfigurační soubor config.php. Klikněte na tlačítko Další krok.

Nyní vás instalátor vyzve na zadání údajů pro přístup k MySQL serveru. Použijte údaje, které jste použili u přípravy MySQL a klikněte na Odeslat.

Pokud jste zadali správné údaje, instalátor vás informuje, že nastavení konfigurace bylo dokončeno. Jinak vás upozorní, že se nepodařilo připojit k databázi s návrhy možných problémů.

Až se vám podaří tyto chyby opravit, klikněte na tlačítko Další krok.

====Volitelné: Ruční vytvoření config.php====

Pokud nemáte práva zápisu do adresáře freenetis, instalátor vám vygeneruje kód, který zkopírujte a uložte jako config.php do adresáře freenetis. '''Dokud tak neučiníte, v instalaci nebude možno pokračovat!'''

===Samotná instalace===

Nyní by se před vámi měla objevit samotná instalace s formulářem s informacemi o vašem sdružení. Po jeho vyplnění by měla být instalace hotova.

====Volitelné: Ruční vytvoření .htaccess====

Pokud jste zatrhli možnost Čistá URL a nemáte práva zápisu do adresáře freenetis, instalátor vám vygeneruje kód, který zkopírujte a uložte jako .htaccess do adresáře freenetis. '''Pokud tak neučiníte, vaše instalace nemusí fungovat korektně!'''

===Zprovoznění "plánovače"===

FreenetIS má v sobě vlastní scheduler který je potřeba pravidelně zpouštět z cronu. Do cronu přidejte tento řádek:

#FreenetIS scheduler
* * * * * root wget -O /dev/null http://<hostname>/cs/scheduler/run

Pokud používáte SSL s neověřeným nebo s neplatným certifikátem použijte:

#FreenetIS scheduler
* * * * * root wget -O /dev/null https://<hostname>/cs/scheduler/run --no-check-certificate

Access rights

2013-12-10T13:02:55Z

Sivosha:

[[cs:Přístupová práva]]
[[ru: Права доступа]]

==Description implementation Rights Management FreenetIS==

The current access rights for FreenetIS based on PHP GACL. Knihodna itself has been removed, but the system tables was maintained.

==Description SQL tables library PhpGacl ==

In PhpGacl everything is built on objects ACO, ARO and AXO.

'' 'ACO''' - facilities operations

'' 'ARO''' - objects (or groups of objects) that want individual operations (ACO) to perform

'' 'AXO''' - objects (or groups of objects), over which the individual ARO want an operation (ACO)

===acl===
Table defining individual access rules.

It contains columns id, section_value, allow, enabled, return_value, note, updated_date.

'''id''' - identifier, important to connect with ACO, ARO and AXO

'''section_value''' - the name of the section where the rule is

'''allow''' - 1 => rule permits the operation, 0 => rule prohibits operation

'''enabled''' - 1 => rule is enabled, 0 => rule is disabled

'''return_value''' - I do not know yet

'''Note''' - a comment describing the rule (eg Administrators can do everything)

'' 'updated_date''' - timestamp of the last update rules

===acl_sections===
Table defining individual sections of the rules.

Default in PhpGacl are two sections - System and User. In FreenetIS uses only User.

It contains columns id, value, order_value, name and hidden.

'''id''' - identifier, more or less useless because the rules are assigned to sections with values (value)

'''value''' - a short name without spaces, used to assign individual ACLs into sections

'''order_value''' - I do not know yet

'''name''' - long title, description

'''hidden''' - 0 => section is visible, 1 => is hidden

===acl_seq===
Table whose sole purpose is to memorize currently the last id of table acl.

PhpGacl (God knows why) does not use the tables auto increment.

Contains a column id.

'' 'id''' - latest id in table acl

===aco===
Table defining individual objects ACO. In FreenetIS are either ACO for rendering menu (sections menu) and ACO for general operations (section freenetis) - view_all, view_own, edit_all, edit_own, delete_all, delete_own, new_all, new_own, confirm_all, confirm_own ... used'' 'only''' with AXO objects.

It contains columns id, section_value, value, order_value, name and hidden.

'''id''' - identifier unimportant (for connection to the ACL table is used aco_map value)

'''section_value''' - section name defined in aco_sections

'''value''' - a short name without spaces, used for the assignment of the ACO into sections and to connect with each ACL rule in aco_map

'''order_value''' - I do not know yet

'''name''' - long title, description

'''hidden''' - 0 => section is visible, 1 => is hidden

===aco_map===

Connects ACO objects with different ACL rules. ACO as one (of the three ACO, ARO and AXO) is unable to clustering in groups, because there is no other table aco_groups_map.

Contains columns acl_id, section_value and value.

'' 'acl_id''' -

'' 'section_value''' -

'' 'value''' -

===aco_sections===

Section for each ACO , FreenetIS uses only two : menu - for ACO objects on the plot menu , and then freenetis - to define the general ACO operations (view, edit , delete and confirmation ) .

It contains columns id , value , order_value , name and hidden .

''' id ''' - identifier section (not needed for anything )

'''value ''' - the name of the section (in our menu and freenetis )

''' order_value ''' - I do not know yet

'''name ''' - description section

'''hidden ''' - 0 => section is visible , 1 = > is hidden

===aro_groups_map===

assigned to individual user groups ACL rules .

Example:

Create a rule "Candidates for membership and regular members can do XYZ" .

This rule will be in the " acl " represented a new row with id = 27 , in which the stored value "allow " ;

If " full members " have id = 22 and those interested in membership id = 23 , then the table aro_groups_map when you create this rule there will be two new lines:

acl_id | group_id
-----------------
27 | 22

27 | 23

===axo_groups_map===

Similar to aro_groups_map , but AXO

Права доступа

2013-12-10T13:02:00Z

Sivosha: Založena nová stránka: cs:Přístupová práva en: Access rights ==Описание реализации управления правами FreenetIS== Текущие права дос...

[[cs:Přístupová práva]]
[[en: Access rights]]

==Описание реализации управления правами FreenetIS==

Текущие права доступа для FreenetIS основаны на PHP GACL. Knihodna сама была удалена, но системные таблицы поддерживаются.

==Описание SQL таблиц библиотеки Phpgacl==

В PhpGacl все построено на объектах ACO, ARO и АХО.

'' 'ACO''' - операции объектов

'' 'ARO''' - объекты (или группы объектов), которые выполняют индивидуальные операции (АСО)

'''АХО''' - объекты (или группы объектов), над которыми индивидуальные ARO выполняют операции (ACO)

===acl===
Таблица определения индивидуальных правил доступа.

Она содержит столбцы id, section_value, allow, enabled, return_value, note, updated_date.

'''ID''' - идентификатор, важен для соединения с ACO, ARO и ОВБ

'''section_value''' - имя секции, где правила

'''allow''' - 1 => Правило разрешает операции, 0 => Правило запрещает операции

'''Enabled''' - 1 => правило включено, 0 => правило отключено

'''return_value''' - Я еще не знаю

'''Note''' - комментарии к правилу (например Администраторы могут делать все)

'''Updated_date''' - дата последнего обновления правил

===acl_sections===
Таблица определения отдельных разделов Правил.

По умолчанию в PhpGacl две секции - System и User. FreenetIS использует только User.

Он содержит столбцы id, value, order_value, name and hidden

'''id''' - идентификатор, более или менее бесполезный, потому что правила относятся к разделам со значениями (значение)

'''значение''' - короткое имя без пробелов, используется для назначения отдельных списков управления доступом на разделы

'''order_value''' - Я еще не знаю

'''Название''' - длинные названия, описания

'''скрытые''' - 0 => Раздел виден, 1 => скрыт

===acl_seq===
Таблица единственной целью котороq является в настоящее время хранение последнего ID таблицы ACL.

PhpGacl (Бог знает почему) не использует автоприращение в таблицах.

Содержит столбец ID.

'' 'ID''' - последняя ID в таблице ACL

===асо===
Таблица определения отдельных объектов ACO. В FreenetIS имеется ACO либо для оказания меню (разделы меню), либо ACO для общих операций (раздел freenetis) - view_all, view_own, edit_all, edit_own, delete_all, delete_own, new_all, new_own, confirm_all, confirm_own ... использованы в'' 'только''' с объектами АХО.

Она содержит столбцы id, section_value, value, order_value, name and hidden.

'''id''' - несущественный идентификатор (для подключения к таблице ACL используется aco_map значение)

'''section_value''' - название раздела определенного в aco_sections

'''value''' - короткое имя без пробелов, используемое для назначения ACO на разделы и подключения к каждому правилу ACL в aco_map

'''order_value''' - Я еще не знаю

'''name''' - длинные названия, описания

'''hidden''' - 0 => Раздел виден, 1 => скрыт

===aco_map===

Соединяет ACO объекты с различными правилами ACL. ACO это один (из трех ACO, ARO и АХО) не в состоянии кластеризироваться в группах, потому что нет никакой другой таблицы aco_groups_map.

Содержит столбцы acl_id, section_value a value.

'' 'Acl_id''' -

'' 'Section_value''' -

'''value''' -

===aco_sections===

Раздел для каждого ACO , FreenetIS использует только два : Меню - для объектов ACO на участке меню, а затем freenetis - определение общих операции ACO ( просмотр, редактирование , удаление и подтверждение) .

Он содержит столбцы id , value , order_value , name and hidden .

''' id ''' - идентификатор раздела ( не используется)

''' value ''' -имя раздела (в нашем меню и freenetis )

''' Order_value ''' - Я еще не знаю

''' name ''' - описание раздела

''' hidden ''' - 0 = > Раздел виден , 1 => скрыт

===aro_groups_map===

присваивает отдельным группам пользователей ACL правила.

Пример:

Создать правило " кандидаты в члены и постоянные члены могут сделать XYZ" .

Это правило будет в " ACL " представлено новой строкой с ID = 27 , в котором хранится значение "Разрешить" ;

Если у " полноправных членов " ID = 22 и тех, кто заинтересован в членстве ID = 23 , то в таблице aro_groups_map при создании этого правила будет две новые записи :

acl_id | group_id
-----------------
27 | 22

27 | 23

===axo_groups_map===

Подобно aro_groups_map , но АХО

Přístupová práva

2013-12-10T13:00:59Z

Sivosha:

[[en:Access rights]]
[[ru: Права доступа]]

==Popis implementace správy přístupových práv ve FreenetISu==

Aktuální přístupová práva pro FreenetIS jsou založena na PHP GACL. Samotná knihodna byla odstraněna, ale její sytém tabulek byl zachován.

==Popis SQL tabulek knihovny PhpGacl==

V PhpGaclu je všechno postavené na objektech ACO, ARO a AXO.

'''ACO''' - objekty operací

'''ARO''' - objekty (nebo skupiny objektů), které chtějí jednotlivé operace (ACO) vykonávat

'''AXO''' - objekty (nebo skupiny objektů), nad kterými chtějí jednotlivé ARO nějakou operaci (ACO)

===acl===
Tabulka definující jednotlivé přístupová pravidla.

Obsahuje sloupce id, section_value, allow, enabled, return_value, note, updated_date.

'''id''' - identifikátor, důležitý pro propojení s ACO, ARO a AXO

'''section_value''' - název sekce, kam toto pravidlo patří

'''allow''' - 1 => pravidlo operaci povoluje, 0 => pravidlo operaci zakazuje

'''enabled''' - 1 => pravidlo je povolené, 0 => pravidlo je zakázané

'''return_value''' - zatím netuším

'''note''' - komentář, popisující funkci pravidla (např. Administrátoři mohouu dělat vše)

'''updated_date''' - timestamp poslednín aktualizace pravidla

===acl_sections===
Tabulka definující jednotlivé sekce pravidel.

Defaultně jsou v PhpGaclu dvě sekce - System a User, FreenetIS ale používá jen User.

Obsahuje sloupce id, value, order_value, name a hidden.

'''id''' - identifikátor, víceméně zbytečný, protože pravidla se do sekcí přiřazují pomocí hodnoty (value)

'''value''' - krátký název bez mezer, používá se pro přiřazení jednotlivých acl do sekcí

'''order_value''' - zatím netuším

'''name''' - dlouhý název, popis

'''hidden''' - 0 => sekce je viditelná, 1 => je skrytá

===acl_seq===
Tabulka, jejíž jediným účelem je zapamatování si aktuálně posledního id tabulky acl.

PhpGacl (bůhví proč) nepoužívá u tabulek auto increment.

Obsahuje sloupec id.

'''id''' - poslední id v tabulce acl

===aco===
Tabulka definující jednotlivé objekty ACO. Ve FreenetISu jsou buď ACO pro vykreslování menu (sekce menu) a ACO pro obecné operace (sekce freenetis) - view_all, view_own, edit_all, edit_own, delete_all, delete_own, new_all, new_own, confirm_all, confirm_own, ... které se používají '''výhradně''' s AXO objekty.

Obsahuje sloupce id, section_value, value, order_value, name a hidden.

'''id''' - identifikátor, nedůležitý (pro propojení s acl v tabulce aco_map se používá value)

'''section_value''' - jméno sekce, definované v aco_sections

'''value''' - krátký název bez mezer, používá se pro přiřazení jednotlivých aco do sekcí a pro propojení s jednotlivými acl pravidly v aco_map

'''order_value''' - zatím netuším

'''name''' - dlouhý název, popis

'''hidden''' - 0 => sekce je viditelná, 1 => je skrytá

===aco_map===

Propojuje ACO objekty s jednotlivými acl pravidly. ACO jako jediné (z trojice ACO, ARO a AXO) nemá možnost shhlukování do skupin, proto není žádná další dabulka aco_groups_map.

Obsahuje sloupce acl_id, section_value a value.

'''acl_id''' -

'''section_value''' -

'''value''' -

===aco_sections===

Sekce pro jednotlivé ACO, FreenetIS používá pouze dvě: menu - pro ACO objekty týkající se vykreslování menu, a pak freenetis - pro definici obecných ACO operací (zobrazení, editování, mazání a potvrzování).

Obsahuje sloupce id, value, order_value, name a hidden.

'''id''' - identifikátor sekce (není pro nic potřeba)

'''value''' - samotný název sekce (u nás menu a freenetis)

'''order_value''' - zatím netuším

'''name''' - popis sekce

'''hidden''' - 0 => sekce je viditelná, 1 => je skrytá

===aro_groups_map===

přiřazuje k jednotlivým ACL pravidlům skupiny uživatelů.

Příklad:

Vytvoříme pravidlo "Zájemci o členství a řádní členové mohou dělat XYZ".

Toto pravidlo bude v tabulce "acl" reprezentováno novým řádek s id=27, ve kterém je uloženo hodnota "allow";

Pokud "řádní členové" mají id=22 a zájemci o členství id=23, pak v tabulce aro_groups_map při vytvoření tohoto pravidla přibudou 2 nové řádky:

acl_id | group_id
-----------------
27 | 22

27 | 23

===axo_groups_map===

Podobné jako aro_groups_map, ale pro AXO

Версии

2013-12-10T12:57:16Z

Sivosha: Založena nová stránka: cs:Verzování en:Versioning Для нумерации версий FreenetIS используется трехзначное число (то есть, XXX). * ...

[[cs:Verzování]]
[[en:Versioning]]

Для нумерации версий FreenetIS используется трехзначное число (то есть, XXX).

* Первое число всегда 1'' (версия 2 должна быть написана на Java EE и пока не предвидится)''

* Второе число является наиболее важным, так как оно сообщает о существенных изменениях и дополнительных функциях. (Можно увидеть в [плане развития http://dev.freenetis.org/projects/freenetis/roadmap])

* Третье число указывает на патчи и незначительные изменения во втором номере версии.

Текущая версия FreenetISu хранится в файле'' '/ version.php'''.

== Версии разработки ==

Вышеуказанные номера версий предназначена для пользователей. Для целей разработки добавлено еще один пункт версии с префиксом ''' ~ '''. В этом пункте может быть одно из следующих:

*''' Dev ''' относится к развитию версии - находится за пределами тестовой ветви (включая нестабильные и неполные реализации новой версии)

*''' Альфа ''' указывает альфа-версии - расположена в тестовой ветви , в основном на стадии тестировании (в том числе с частично завершенной реализацией)

*''' Бета ''' обозначает бета-версии - расположена в отрасли , в основном в тестировании

*''' Rc '' ' означает релиз-кандидат версии - находится в стадии тестирования (сделано отлаженную реализацию заключительного теста )

По пункту все еще может быть номер, который позволяет создавать несколько версий одного и того же пункта. Сортировка версии (используется, например , в [ http://wiki.freenetis.org/index.php/Autoupdate_DB_struktury Autoupdate_DB_struktury ] ) совпадает с порядком в списке (т.е. разработчика < альфа < бета < RC) . Все версии развития сортируются до выхода финальной версии (XXX) .

=== Пример развития номеров версий ===

Рассмотрим текущую версию 1.5.0. Мы постепенно развиваем версию 1.6.0, наш прогресс в версии может быть следующий:

* Несколько версий развития в отдельной ветке (1.6.0 ~ dev1, dev2 ~ .6.0, ...).
* В результате разработка постепенно альфа-версии (1.6.0 ~ alpha1, 1.6.0 ~ alpha1, ...).
* После завершения всех основных изменений, мы объединяем версии в тестировании и отладке которое мы обозначим как ~ 1.6.0 бета и выпускаэм бета-версию.
* После отладки предлагаем пользователям принять участие в тестировании RC Если Вы обнаружили ошибки, исправляем их и выпускаем еще один RC (1.6.0 ~ rc1 ...).
* Если все в порядке, мы объединяем результаты и выпускаем главную версию (1.6.0)
* Если вы нашли после выхода некоторые ошибки мы публикуем их в качестве версий 1.6.1, 1.6.2, ... до тех пор, пока вы не объявляем о прекращении поддержки версии.

Versioning

2013-12-10T12:56:07Z

Sivosha:

[[cs:Verzování]]
[[ru:Версии]]

FreenetIS versioning uses a three-digit number (ie, xxx).

* The first number is always 1'' (version 2 has been written in Java EE and is not yet in sight)''

* The second number is the most important, as it informs the extensive changes and added functionality. (can be seen in [http://dev.freenetis.org/projects/freenetis/roadmap development plan])

* The third number information on patches and minor changes in the second version number.

Current version FreenetISu instance is stored in the file'' '/ version.php'''.

Developer version ==

The above versioning is intended for distribution among the users ( ie in the branch trunk ) . For development purposes, added another item version prefixed by '' '~ ''' . For this feature can be stated precisely one of the following items :

*'' ' Dev ''' refers to the development version - located outside the testing branch (includes unstable and incomplete implementation of the new version )

*'' ' Alpha ''' indicates alpha version - located in the branch , mainly in testing (includes partially completed implementation)

*'' ' Beta '' ' denotes the beta version - located in the branch , mainly in testing (includes shelf implementations suitable for testing )

*'' ' Rc '' ' stands for Release Candidate version - is in testing ( done debugged implementation to final test )

For item can still be a number that allows you to create multiple versions of the same item and arrange it for you. Sort versions ( used eg in [ http://wiki.freenetis.org/index.php/Autoupdate_DB_struktury Autoupdate_DB_struktury ] ) is identical to the order of the list ( ie dev < alpha < beta < rc ) . All development versions are sorted before the final version (xxx )

=== Example of versioning development ===

Consider a current version 1.5.0. We gradually develop version 1.6.0, our progress in versioning could be the following:

* Several developmental version in a separate Branch (1.6.0 ~ dev1, dev2 ~ .6.0, ...).
* The result of the development costs progressively as the alpha version (1.6.0 ~ alpha1, 1.6.0 ~ alpha1, ...).
* After completing all of the major changes we merge into testing, which we denote as ~ 1.6.0 beta, and debugging released the beta version.
* After debugging offer users even in testing RC if you find errors, fix them and release another RC (1.6.0 ~ rc1 ...).
* If everything is OK we will merge into the trunk and head version (1.6.0)
* If you are found after the release of some errors we publish them as versions 1.6.1, 1.6.2, ... for as long as you do not declare for an unsupported version.

Verzování

2013-12-10T12:46:52Z

Sivosha:

[[en:Versioning]]
[[ru:Версии]]

FreenetIS používá třímístné verzovací číslo (tj. x.x.x).

* První číslo je vždy 1 ''(verze 2 má být napsána v Java EE a je zatím v nedohlednu)''

* Druhé číslo je nejdůležitějším, jelikož informuje o rozsáhlých změnách a přidané funkcionalitě. (lze pozorovat v [http://dev.freenetis.org/projects/freenetis/roadmap plánu vývoje])

* Třetí číslo informuje o záplatách a drobných změnách ve verzi dané druhým číslem.

Aktuální verze instance FreenetISu je uložena v souboru '''/version.php'''.

== Vývojářské verze ==

Výše zmíněné verzování je určeno pro distribuci mezi uživatele (tj. ve větvi trunk). Pro vývojářské účely je přidána další položka verze uvozená znakem '''~'''. Za tímto znakem může být uvedena právě jedna z následujících položek:

* '''dev''' označuje vývojářskou verzi - nachází v branchích mimo testing (obsahuje nestabilní a neúplné implementace nových verzí)

* '''alpha''' označuje aplha verzi - nachází se v branchích, převážně v testingu (obsahuje částečně hotové implementace)

* '''beta''' označuje beta verzi - nachází se v branchích, převážně v testingu (obsahuje hotové implementace vhodné pro otestování)

* '''rc''' označuje Release Candidate verzi - nachází se v testingu (hotové odladěná implementace k finálnímu otestování)

Za položkou může být ještě číslo, které umožňuje vytvářet více verzí se stejnou položkou a řadit je za sebou. Řazení verzí (použité např. při [http://wiki.freenetis.org/index.php/Autoupdate_DB_struktury Autoupdate_DB_struktury]) je shodné s pořadím v seznamu (tj. dev < alpha < beta < rc). Všechny vývojářské verze jsou řazeny před finální verze (x.x.x).

=== Příklad verzování vývojové verze ===

Mějme aktuální verzi 1.5.0. Chceme postupně vyvinout verzi 1.6.0, náš postup ve verzování by mohl být například následující:

* Několik vývojových verzi v samostatné branchi (1.6.0~dev1, .6.0~dev2, ...).
* Výsledek vývoje vydáme postupně jako alpha verze (1.6.0~alpha1, 1.6.0~alpha1, ...).
* Po dokončení všech hlavních změn uděláme merge do testingu, který označíme jako 1.6.0~beta, a do odladění vydáváme další beta verze.
* Po odladění nabídneme v testingu uživatelům ještě RC, pokud narazíme na chyby, opravíme je a vydáme další RC (1.6.0~rc1, ...).
* Pokud je vše OK provedeme merge do trunku a vydáme verzi (1.6.0)
* Pokud po vydání jsou nalezeny nějaké chyby vydáváme je jako verze 1.6.1, 1.6.2, ... do doby, dokud verzi neprohlásíme za nepodporovanou.

Settings

2013-12-10T12:42:54Z

Sivosha:

[[cs:Nastavení]]
[[ru:Настройки]]

Like any other information system and FreenetIS must have the possibility of various settings to the user and the system. At present, the more care two libraries:

application / libraries / settings.php (to set through a database)
system / core / config.php (to set through the configuration file)

= Initial state =

In original condition Kohana framework supported only setting in the configuration file, no database setup over there. It follows that the system did not go to create form settings - you then have to pre-generate these files => big security risk.

= Current Status =

Almost all the settings have been moved into the database. In the configuration file leaving only the access data to the database.

= Actual implementation =

== Library Settings ==

All settings are stored in a database table Config.

=== Variables ===

==== contact ====

==== currency ====

- The currency that is used in the system

- Can be set in Settings - System - Currency

-'' 'Default''': CZK

==== db_schema_version ====

- Probably the most important variable - Specifies the current revision of the database schema used in the [[Autoupdate DB structure]]

-'''Can not be set by the user in the system, determines itself'''

==== Debtor ====
==== default_country ====
- Basic country used in a system (id from table countries)

-'' 'Default''': 55 (Czech Republic)
domain ==== ====

- Domain, which runs on FreenetIS

- If your address FreenetISu <nowiki> http://www.mojedomena.cz/freenetis/ </ nowiki>, this variable <nowiki> www.mojedomena.cz </ nowiki>

-'' 'Default''': empty (for a URL then use server :: HTTP_HOST ())

====email_default_email ====

- Default e-mail - all e-mails sent from FreenetIS will be listed as the sender of this address

- Can be set in Settings - System - Default e-mail

-'' 'Default''': no-reply@freenetis.org

====email_driver====

- Driver sending e-mail - the way they send e-mails

- The possible options - native (using php mail), SMTP and Sendmail

- Set in the Settings - E-mail - Driver

-'' 'Default''': native

====email_hostname====

- SMTP server host

- Is taken into account only if it is set to SMTP email_driver

- Set in the Settings - E-mail - Host Name

-'' 'Default''': empty

====email_port====

- SMTP server port

- Is taken into account only if it is set to SMTP email_driver

- Set in the Settings - E-mail - Port

-'''Default''': 25

====EMAIL_PASSWORD====

- Password for the SMTP server host

- Is taken into account only if it is set to SMTP email_driver

- Set in the Settings - E-mail - Password

-'' 'Default''': empty

====email_username====

- Username to access the SMTP server host

- Is taken into account only if it is set to SMTP email_driver

- Set in the Settings - E-mail - User Name

-'' 'Default''': empty

====gateway====

====index_page====

- Boolean variable, whether it is displayed index.php in the URL

- 1 => will be displayed, 0 => will be not displayed

- Can be set in Settings - System - Clean URL (via negation)

-'''Default''' 1

====info====

====interrupt====

====map_google_maps_api_key====

- Key for Google Maps API, which is in use.

-'''Default''': empty

====optional_message====

====payment_notice====

====protocol====

- Protocol, which runs on FreenetIS

- If your address FreenetISu <nowiki> http://www.mojedomena.cz/freenetis/ </ nowiki>, this variable <nowiki> http </ nowiki>

-'' 'Default''': empty (for a URL is used the value of http)

====registration_info====

- Information that appears on the exported on top of application

-'' 'Default''': empty

====registration_license====

- Licensing conditions that appear on the bottom of the exported application

-'' 'Default''': empty

====self_registration====

- Logical variable whether to allow self-registration of candidates for membership

- Can be set in Settings - System - Self-Registration

-'' 'Default''' 1

====suffix====

- Suffix for the domain in the URL, which runs FreenetIS

- If your address FreenetISu <nowiki> http://www.mojedomena.cz/freenetis/ </ nowiki>, this variable <nowiki> / freenetis / </ nowiki>

- Must always begin and end with a slash (may be /)

-'' 'Default''': empty (for a URL is then used substr (server :: SCRIPT_NAME (), 0, -9))

====title====

- Page title that appears in the header (inside the HTML title attribute)

- Can be set in Settings - System - Page title

-'' 'Default''': FreenetIS

====unknown device====

====upload directory====

- Specifies the directory in which to upload files (imports, etc.)

-'''Default''' upload

====use_javascript====

- Boolean variable, whether it is used javascript

- Obsolete, in the future will be removed

-'' 'Default''' 1

====voip_billing_driver====
- Variable contains the currently selected driver for VoIP

- Currently supported for VOIP solutions only drver from NFX z.s.p.o.

-'' 'Default''' 0

====voip_billing_partner====

- Variable contains the user name to log on to billing

-'' 'Default''' empty

====voip_billing_password====
- Variable contains the user password to log on to billing

-'''Default''' empty

====voip_number_exclude====
- Variable contains a nine-digit numbers separated by a semicolon (;)

- The figures shown in this list are not offered for selection for the registration of VoIP account

-'''Default''' empty

====voip_number_interval====
- Variable contains a nine-digit number in the range of shape-XXXXXXXXX XXXXXXXXX

- The figures shown in this list are offered for selection for the registration of VoIP account

-'''Default''' empty

====voip_sip_server====
- Variable holds a string with the SIP server hostname. Eg. sip.slfree.czf

- Appears in VoIP account as additional information. It has no effect on the control panel.

-'' 'Default''': empty

====website_after_redirection====

===Methods===

The entire library contains only two methods - set and get.

The controller and the views is used to dynamically access - at the top of the controller creates an instance of the library:

$ this-> settings = new Settings ();

and then as the value of the variable suffix is obtained as follows:

$ this-> Settings-> get ('suffix');

In the other application (helpers, etc.) must then use the static approach:

$ suffix = Settings :: get ('suffix');

====Get====

- Returns the value specified by the key

- If it finds a non-empty value, return it

- If it finds a null value or an unexpected error happens, it checks whether there is a private attribute of the same name (ie default)

- If it exists, return it

- If there is, try to return the same name variable from the config (the config file)

=== set ====

- Set the variable input with keys to the specified value

- If an unexpected error occurs, it returns failure

- Else if variable already exists in the database, updates it

- Attempt to create variable in the database if does not exist,

==Library Config==

These are the settings that are written to the configuration file config.php.

It is, however, only variables with data for the database connection.

===Variables===

====db_type====

- Database type (mysql, pgsql)

- Yet is only supported by MySQL

-'''Default''': mysql

====db_name====

- Name of the database, which runs FreenetIS

-'''Default''': freenetis

====db_host====

- The address of the host that will run FreenetIS

-'''Default''': localhost

====db_user====

- User name to connect to the database

-'''Default''': freenetis

====DB_PASSWORD====

- The user password for the database connection

-'''Default''': freenetis

====db_table_prefix====

- Prefix for tables FreenetIS

- Useful if you want to use a common database for FreenetIS and other project

-'''Default''': empty

===Methods===

Unlike libraries Settings at the library only uses static approach:

$ db_name = Config :: get ('db_name')

===Get====

- Returns the value of the configuration file according to a specified key

===set====

- Set the desired value for the specified key

Settings

2013-12-10T12:42:37Z

Sivosha:

[[cs:Nastavení]]
[[ru:Настройки]]

[[en: Settings]]
Like any other information system and FreenetIS must have the possibility of various settings to the user and the system. At present, the more care two libraries:

application / libraries / settings.php (to set through a database)
system / core / config.php (to set through the configuration file)

= Initial state =

In original condition Kohana framework supported only setting in the configuration file, no database setup over there. It follows that the system did not go to create form settings - you then have to pre-generate these files => big security risk.

= Current Status =

Almost all the settings have been moved into the database. In the configuration file leaving only the access data to the database.

= Actual implementation =

== Library Settings ==

All settings are stored in a database table Config.

=== Variables ===

==== contact ====

==== currency ====

- The currency that is used in the system

- Can be set in Settings - System - Currency

-'' 'Default''': CZK

==== db_schema_version ====

- Probably the most important variable - Specifies the current revision of the database schema used in the [[Autoupdate DB structure]]

-'''Can not be set by the user in the system, determines itself'''

==== Debtor ====
==== default_country ====
- Basic country used in a system (id from table countries)

-'' 'Default''': 55 (Czech Republic)
domain ==== ====

- Domain, which runs on FreenetIS

- If your address FreenetISu <nowiki> http://www.mojedomena.cz/freenetis/ </ nowiki>, this variable <nowiki> www.mojedomena.cz </ nowiki>

-'' 'Default''': empty (for a URL then use server :: HTTP_HOST ())

====email_default_email ====

- Default e-mail - all e-mails sent from FreenetIS will be listed as the sender of this address

- Can be set in Settings - System - Default e-mail

-'' 'Default''': no-reply@freenetis.org

====email_driver====

- Driver sending e-mail - the way they send e-mails

- The possible options - native (using php mail), SMTP and Sendmail

- Set in the Settings - E-mail - Driver

-'' 'Default''': native

====email_hostname====

- SMTP server host

- Is taken into account only if it is set to SMTP email_driver

- Set in the Settings - E-mail - Host Name

-'' 'Default''': empty

====email_port====

- SMTP server port

- Is taken into account only if it is set to SMTP email_driver

- Set in the Settings - E-mail - Port

-'''Default''': 25

====EMAIL_PASSWORD====

- Password for the SMTP server host

- Is taken into account only if it is set to SMTP email_driver

- Set in the Settings - E-mail - Password

-'' 'Default''': empty

====email_username====

- Username to access the SMTP server host

- Is taken into account only if it is set to SMTP email_driver

- Set in the Settings - E-mail - User Name

-'' 'Default''': empty

====gateway====

====index_page====

- Boolean variable, whether it is displayed index.php in the URL

- 1 => will be displayed, 0 => will be not displayed

- Can be set in Settings - System - Clean URL (via negation)

-'''Default''' 1

====info====

====interrupt====

====map_google_maps_api_key====

- Key for Google Maps API, which is in use.

-'''Default''': empty

====optional_message====

====payment_notice====

====protocol====

- Protocol, which runs on FreenetIS

- If your address FreenetISu <nowiki> http://www.mojedomena.cz/freenetis/ </ nowiki>, this variable <nowiki> http </ nowiki>

-'' 'Default''': empty (for a URL is used the value of http)

====registration_info====

- Information that appears on the exported on top of application

-'' 'Default''': empty

====registration_license====

- Licensing conditions that appear on the bottom of the exported application

-'' 'Default''': empty

====self_registration====

- Logical variable whether to allow self-registration of candidates for membership

- Can be set in Settings - System - Self-Registration

-'' 'Default''' 1

====suffix====

- Suffix for the domain in the URL, which runs FreenetIS

- If your address FreenetISu <nowiki> http://www.mojedomena.cz/freenetis/ </ nowiki>, this variable <nowiki> / freenetis / </ nowiki>

- Must always begin and end with a slash (may be /)

-'' 'Default''': empty (for a URL is then used substr (server :: SCRIPT_NAME (), 0, -9))

====title====

- Page title that appears in the header (inside the HTML title attribute)

- Can be set in Settings - System - Page title

-'' 'Default''': FreenetIS

====unknown device====

====upload directory====

- Specifies the directory in which to upload files (imports, etc.)

-'''Default''' upload

====use_javascript====

- Boolean variable, whether it is used javascript

- Obsolete, in the future will be removed

-'' 'Default''' 1

====voip_billing_driver====
- Variable contains the currently selected driver for VoIP

- Currently supported for VOIP solutions only drver from NFX z.s.p.o.

-'' 'Default''' 0

====voip_billing_partner====

- Variable contains the user name to log on to billing

-'' 'Default''' empty

====voip_billing_password====
- Variable contains the user password to log on to billing

-'''Default''' empty

====voip_number_exclude====
- Variable contains a nine-digit numbers separated by a semicolon (;)

- The figures shown in this list are not offered for selection for the registration of VoIP account

-'''Default''' empty

====voip_number_interval====
- Variable contains a nine-digit number in the range of shape-XXXXXXXXX XXXXXXXXX

- The figures shown in this list are offered for selection for the registration of VoIP account

-'''Default''' empty

====voip_sip_server====
- Variable holds a string with the SIP server hostname. Eg. sip.slfree.czf

- Appears in VoIP account as additional information. It has no effect on the control panel.

-'' 'Default''': empty

====website_after_redirection====

===Methods===

The entire library contains only two methods - set and get.

The controller and the views is used to dynamically access - at the top of the controller creates an instance of the library:

$ this-> settings = new Settings ();

and then as the value of the variable suffix is obtained as follows:

$ this-> Settings-> get ('suffix');

In the other application (helpers, etc.) must then use the static approach:

$ suffix = Settings :: get ('suffix');

====Get====

- Returns the value specified by the key

- If it finds a non-empty value, return it

- If it finds a null value or an unexpected error happens, it checks whether there is a private attribute of the same name (ie default)

- If it exists, return it

- If there is, try to return the same name variable from the config (the config file)

=== set ====

- Set the variable input with keys to the specified value

- If an unexpected error occurs, it returns failure

- Else if variable already exists in the database, updates it

- Attempt to create variable in the database if does not exist,

==Library Config==

These are the settings that are written to the configuration file config.php.

It is, however, only variables with data for the database connection.

===Variables===

====db_type====

- Database type (mysql, pgsql)

- Yet is only supported by MySQL

-'''Default''': mysql

====db_name====

- Name of the database, which runs FreenetIS

-'''Default''': freenetis

====db_host====

- The address of the host that will run FreenetIS

-'''Default''': localhost

====db_user====

- User name to connect to the database

-'''Default''': freenetis

====DB_PASSWORD====

- The user password for the database connection

-'''Default''': freenetis

====db_table_prefix====

- Prefix for tables FreenetIS

- Useful if you want to use a common database for FreenetIS and other project

-'''Default''': empty

===Methods===

Unlike libraries Settings at the library only uses static approach:

$ db_name = Config :: get ('db_name')

===Get====

- Returns the value of the configuration file according to a specified key

===set====

- Set the desired value for the specified key

Настройки

2013-12-10T12:25:23Z

Sivosha:

[[cs:Nastavení]]
[[en:Settings]]

Как и любой другой информации о системе и FreenetIS должны быть возможности различных настроек для пользователя и системы. В настоящее время для этого предназначены две библиотеки:

application / libraries / settings.php (установить через базу данных)
system / core / config.php (для установки через файл конфигурации)

= Исходное состояние =

В первоначальном состоянии Кохана поддерживает только установки в конфигурационном файле, никаких настроек в базе данных нет. Отсюда следует, что система не создает формы настройки - Вы тогда вынуждены эти файлы предварительно сгенерировать => большой риск для безопасности.

= Текущий статус =

Почти все настройки были перенесены в базу данных. В файле конфигурации остались только настройки доступа к базе данных.

= Фактическая реализация =

== Настройки библиотеки ==

Все настройки хранятся в таблице конфигурации базы данных.

=== Переменные ===

==== Контакт ====

==== Валюта ====

- Валюта, которая используется в системе

- Может быть установлена в меню Настройки - Система - Обмен

-'' 'По умолчанию''': CZK

==== Db_schema_version ====

- Вероятно, наиболее важная переменная - Задает текущую версию схемы базы данных, используемую в [[Autoupdate структуры БД]]

-'''Не может быть установлена пользователем в системе, определяет сама себя'''

==== Дебитор ====
==== Default_country ====
- Основная страна, используемая в системе (ID из таблицы стран)

-'''По умолчанию''': 55 (Чехия)
====Домен====

- Домен, который работает на FreenetIS

- Если ваш адрес FreenetISu <nowiki> http://www.mojedomena.cz/freenetis/ </ Nowiki>, эта переменная <nowiki> www.mojedomena.cz </ Nowiki>

-'' 'По умолчанию''': пусто (для URL, используя сервер :: HTTP_HOST ())

==== Email_default_email ====

- Электронная почта по умолчанию - все электронные письма, отправленные с FreenetIS будет отправлены с этого адреса

- Может быть установлена в меню Настройки - Система - электронная почта по умолчанию

-'' 'По умолчанию''': no-reply@freenetis.org

====Email_driver====

- Протокол отправки электронной почты - протокол, по которому будет отправляться электронная почта

- Возможные варианты - родной (с использованием PHP), SMTP и Sendmail

- Установить в настройках - Электронная почта - Протокол

-'' 'По умолчанию''': родной

====Email_hostname====

- SMTP хост-сервера

- Учитывается только тогда, когда установлен SMTP email_driver

- Установить в настройках - Электронная почта - Имя хоста

-'' 'По умолчанию''': пусто

====Email_port====

- Порт сервера SMTP

- Учитывается только тогда, когда установлен SMTP email_driver

- Установить в настройках - Электронная почта - Порт

-'''По умолчанию''': 25

====EMAIL_PASSWORD====

- Пароль для хост-сервера SMTP

- Учитывается только тогда, когда установлен SMTP email_driver

- Установить в настройках - E-MAIL - Пароль

-'' 'По умолчанию''': пусто

====email_username====

- Имя пользователя для доступа к SMTP хост-серверу

- Учитывается только тогда, когда установлен SMTP email_driver

- Установить в настройках - Электронная почта - имя пользователя

-'' 'По умолчанию''': пусто

====шлюз====

====index_page====

- Логическая переменная, будет ли отображается index.php в URL

- 1 => будет отображаться, 0 => не будет отображаться

- Может быть установлена в меню Настройки - Система - Чистый URL (через отрицание)

-'' 'По умолчанию''' 1

====информация====

====Прерывание========

====Map_google_maps_api_key====

- Ключ для Google Maps API, который находится в использовании.

-'''По умолчанию''': пусто

====Optional_message====

====Payment_notice====

====Протокол====

- Протокол, который работает на FreenetIS

- Если ваш адрес FreenetISu <nowiki> http://www.mojedomena.cz/freenetis/ </ Nowiki>, эта переменная <nowiki> HTTP </ Nowiki>

-'' 'По умолчанию''': пусто (для URL используется значение HTTP)

====Registration_info====

- Информация, которая появляется поверх экспортируемых приложений

-'' 'По умолчанию''': пусто

====Registration_license====

- Лицензионные условия, которые появляются в нижней части экспортированных приложений

-'' 'По умолчанию''': пусто

====Self_registration====

- Логическая переменная - следует ли разрешить самостоятельную регистрацию кандидатов в члены

- Может быть установлена в меню Настройки - Система - Самостоятельная регистрация

-'' 'По умолчанию''' 1

====суффикс====

- Суффикс домена в URL, где функционирует FreenetIS

- Если ваш адрес FreenetISu <nowiki> http://www.mojedomena.cz/freenetis/ </ Nowiki>, эта переменная <nowiki> / freenetis / </ Nowiki>

- Всегда должно начинаться и заканчиваться косой чертой (может быть /)

-'' 'По умолчанию''': пусто (для URL затем используется SUBSTR (Server :: SCRIPT_NAME (), 0, -9))

====title====

- Название страницы, которая появляется в заголовке (внутри HTML атрибут названия)

- Может быть установлена в меню Настройки - Система - Название страницы

-'' 'По умолчанию''': FreenetIS

====неизвестное устройство====

====Загрузочный каталог====

- Задает каталог для загрузки файлов (импорт, и т.д.)

-'''По умолчанию''' upload

====Use_javascript====

- Логическая переменная, используется ли JavaScript

- Устаревшая, в будущем будет удалена

-'''По умолчанию''' 1
====Voip_billing_driver====
- Переменная определяющая драйвер для VoIP

- В настоящее время поддерживаются только драйвер от NFX z.s.p.o.
для VOIP решения
-'' 'По умолчанию''' 0

====voip_billing_partner====

- Переменная содержит имя пользователя для входа в биллинг

-'' 'По умолчанию''' пусто

====Voip_billing_password====
- Переменная содержит пароль пользователя для входа в биллинг

-'' 'По умолчанию''' пусто

====Voip_number_exclude====
- Переменная содержит девятизначные числа, разделенные точкой с запятой (;)

- Показатели, представленные в этом списке не предлагаются для выбора для регистрации счета VoIP

-'' 'По умолчанию''' пусто

====voip_number_interval====
- Переменная содержит девять-значное число в диапазоне по шаблону XXXXXXXXX XXXXXXXXX

- Показатели, представленные в этом списке на выбор предлагаются для регистрации счета VoIP

-'' 'По умолчанию''' пусто

====Voip_sip_server====
- Переменная содержит строку с сервера SIP хоста. Например. sip.slfree.czf

- Появляется в VoIP счете в качестве дополнительной информации. Это не имеет никакого влияния на панель управления.

-'' 'По умолчанию''': пусто

====Website_after_redirection====

===Методы====

Вся библиотека содержит только два метода - устанавки и получения.

Контроллер и виды (views) используются для динамического доступа - в верхней части контроллера создается экземпляр библиотеки:

$ this-> settings = new Settings();

и затем, как значение переменной суффикс получают следующим образом:

$ this-> settings->get('suffix');

В другом приложении (помощники и т.д.) должны использовать статический подход:

$suffix = Settings::get('suffix');

====Получить====

- Возвращает значение, определяемое ключом

- Если он находит непустое значение, возвращает его

- Если он находит нулевое значение или возникает непредвиденная ошибка, проверяет, есть ли частный атрибут с таким же названием (т.е. по умолчанию)

- Если он существует, возвращает его

- Если есть, попытаться вернуть то же имя переменной из конфигурации (конфигурационного файла)

====установить====

- Установка входных переменных с заданными ключами

- Если возникает непредвиденная ошибка, возвращает ошибку

- Иначе, если переменная уже существует в базе данных, обновляет ее

- Если переменной в базе данных не существует, пытается создать ее

==Библиотека Config==

Это те параметры, которые записываются в файл конфигурации config.php.

Это, однако, только с переменные параметров подключения к базе данных.

===Переменные===

====Db_type====

- Тип базы данных (MySQL, PgSQL)

- Тем не менее, поддерживается только MySQL

-'''По умолчанию''': MySQL

====DB_NAME====

- Имя базы данных FreenetIS

-'' 'По умолчанию''': freenetis

====DB_HOST====

- Адрес хоста, на котором будет работать FreenetIS

-'''По умолчанию''': local

====DB_USER====

- Имя пользователя для подключения к базе данных

-'''По умолчанию''': freenetis

====DB_PASSWORD====

- Пароль пользователя для подключения к базе данных

-'''По умолчанию''': freenetis

====Db_table_prefix====

- Префикс для таблиц FreenetIS

- Полезно, если вы ,будете использовать общую базу данных для FreenetIS и для других проектов

-'' 'По умолчанию''': пусто

===Методы===

В отличие от настройки библиотек используется только статический подход:

DB_NAME = $ Config :: get ('db_name')

====Получить====

- Возвращает значение из файла конфигурации, в соответствии с указанным ключом

====Установить====

- Установите нужное значение для указанного ключа

Настройки

2013-12-10T12:24:11Z

Sivosha: Založena nová stránka: cs:Nastavení en:Settings EN: Настройки Как и любой другой информации о системе и FreenetIS должны быть в...

[[cs:Nastavení]]
[[en:Settings]]

[[EN: Настройки]]
Как и любой другой информации о системе и FreenetIS должны быть возможности различных настроек для пользователя и системы. В настоящее время для этого предназначены две библиотеки:

application / libraries / settings.php (установить через базу данных)
system / core / config.php (для установки через файл конфигурации)

= Исходное состояние =

В первоначальном состоянии Кохана поддерживает только установки в конфигурационном файле, никаких настроек в базе данных нет. Отсюда следует, что система не создает формы настройки - Вы тогда вынуждены эти файлы предварительно сгенерировать => большой риск для безопасности.

= Текущий статус =

Почти все настройки были перенесены в базу данных. В файле конфигурации остались только настройки доступа к базе данных.

= Фактическая реализация =

== Настройки библиотеки ==

Все настройки хранятся в таблице конфигурации базы данных.

=== Переменные ===

==== Контакт ====

==== Валюта ====

- Валюта, которая используется в системе

- Может быть установлена в меню Настройки - Система - Обмен

-'' 'По умолчанию''': CZK

==== Db_schema_version ====

- Вероятно, наиболее важная переменная - Задает текущую версию схемы базы данных, используемую в [[Autoupdate структуры БД]]

-'''Не может быть установлена пользователем в системе, определяет сама себя'''

==== Дебитор ====
==== Default_country ====
- Основная страна, используемая в системе (ID из таблицы стран)

-'''По умолчанию''': 55 (Чехия)
====Домен====

- Домен, который работает на FreenetIS

- Если ваш адрес FreenetISu <nowiki> http://www.mojedomena.cz/freenetis/ </ Nowiki>, эта переменная <nowiki> www.mojedomena.cz </ Nowiki>

-'' 'По умолчанию''': пусто (для URL, используя сервер :: HTTP_HOST ())

==== Email_default_email ====

- Электронная почта по умолчанию - все электронные письма, отправленные с FreenetIS будет отправлены с этого адреса

- Может быть установлена в меню Настройки - Система - электронная почта по умолчанию

-'' 'По умолчанию''': no-reply@freenetis.org

====Email_driver====

- Протокол отправки электронной почты - протокол, по которому будет отправляться электронная почта

- Возможные варианты - родной (с использованием PHP), SMTP и Sendmail

- Установить в настройках - Электронная почта - Протокол

-'' 'По умолчанию''': родной

====Email_hostname====

- SMTP хост-сервера

- Учитывается только тогда, когда установлен SMTP email_driver

- Установить в настройках - Электронная почта - Имя хоста

-'' 'По умолчанию''': пусто

====Email_port====

- Порт сервера SMTP

- Учитывается только тогда, когда установлен SMTP email_driver

- Установить в настройках - Электронная почта - Порт

-'''По умолчанию''': 25

====EMAIL_PASSWORD====

- Пароль для хост-сервера SMTP

- Учитывается только тогда, когда установлен SMTP email_driver

- Установить в настройках - E-MAIL - Пароль

-'' 'По умолчанию''': пусто

====email_username====

- Имя пользователя для доступа к SMTP хост-серверу

- Учитывается только тогда, когда установлен SMTP email_driver

- Установить в настройках - Электронная почта - имя пользователя

-'' 'По умолчанию''': пусто

====шлюз====

====index_page====

- Логическая переменная, будет ли отображается index.php в URL

- 1 => будет отображаться, 0 => не будет отображаться

- Может быть установлена в меню Настройки - Система - Чистый URL (через отрицание)

-'' 'По умолчанию''' 1

====информация====

====Прерывание========

====Map_google_maps_api_key====

- Ключ для Google Maps API, который находится в использовании.

-'''По умолчанию''': пусто

====Optional_message====

====Payment_notice====

====Протокол====

- Протокол, который работает на FreenetIS

- Если ваш адрес FreenetISu <nowiki> http://www.mojedomena.cz/freenetis/ </ Nowiki>, эта переменная <nowiki> HTTP </ Nowiki>

-'' 'По умолчанию''': пусто (для URL используется значение HTTP)

====Registration_info====

- Информация, которая появляется поверх экспортируемых приложений

-'' 'По умолчанию''': пусто

====Registration_license====

- Лицензионные условия, которые появляются в нижней части экспортированных приложений

-'' 'По умолчанию''': пусто

====Self_registration====

- Логическая переменная - следует ли разрешить самостоятельную регистрацию кандидатов в члены

- Может быть установлена в меню Настройки - Система - Самостоятельная регистрация

-'' 'По умолчанию''' 1

====суффикс====

- Суффикс домена в URL, где функционирует FreenetIS

- Если ваш адрес FreenetISu <nowiki> http://www.mojedomena.cz/freenetis/ </ Nowiki>, эта переменная <nowiki> / freenetis / </ Nowiki>

- Всегда должно начинаться и заканчиваться косой чертой (может быть /)

-'' 'По умолчанию''': пусто (для URL затем используется SUBSTR (Server :: SCRIPT_NAME (), 0, -9))

====title====

- Название страницы, которая появляется в заголовке (внутри HTML атрибут названия)

- Может быть установлена в меню Настройки - Система - Название страницы

-'' 'По умолчанию''': FreenetIS

====неизвестное устройство====

====Загрузочный каталог====

- Задает каталог для загрузки файлов (импорт, и т.д.)

-'''По умолчанию''' upload

====Use_javascript====

- Логическая переменная, используется ли JavaScript

- Устаревшая, в будущем будет удалена

-'''По умолчанию''' 1
====Voip_billing_driver====
- Переменная определяющая драйвер для VoIP

- В настоящее время поддерживаются только драйвер от NFX z.s.p.o.
для VOIP решения
-'' 'По умолчанию''' 0

====voip_billing_partner====

- Переменная содержит имя пользователя для входа в биллинг

-'' 'По умолчанию''' пусто

====Voip_billing_password====
- Переменная содержит пароль пользователя для входа в биллинг

-'' 'По умолчанию''' пусто

====Voip_number_exclude====
- Переменная содержит девятизначные числа, разделенные точкой с запятой (;)

- Показатели, представленные в этом списке не предлагаются для выбора для регистрации счета VoIP

-'' 'По умолчанию''' пусто

====voip_number_interval====
- Переменная содержит девять-значное число в диапазоне по шаблону XXXXXXXXX XXXXXXXXX

- Показатели, представленные в этом списке на выбор предлагаются для регистрации счета VoIP

-'' 'По умолчанию''' пусто

====Voip_sip_server====
- Переменная содержит строку с сервера SIP хоста. Например. sip.slfree.czf

- Появляется в VoIP счете в качестве дополнительной информации. Это не имеет никакого влияния на панель управления.

-'' 'По умолчанию''': пусто

====Website_after_redirection====

===Методы====

Вся библиотека содержит только два метода - устанавки и получения.

Контроллер и виды (views) используются для динамического доступа - в верхней части контроллера создается экземпляр библиотеки:

$ this-> settings = new Settings();

и затем, как значение переменной суффикс получают следующим образом:

$ this-> settings->get('suffix');

В другом приложении (помощники и т.д.) должны использовать статический подход:

$suffix = Settings::get('suffix');

====Получить====

- Возвращает значение, определяемое ключом

- Если он находит непустое значение, возвращает его

- Если он находит нулевое значение или возникает непредвиденная ошибка, проверяет, есть ли частный атрибут с таким же названием (т.е. по умолчанию)

- Если он существует, возвращает его

- Если есть, попытаться вернуть то же имя переменной из конфигурации (конфигурационного файла)

====установить====

- Установка входных переменных с заданными ключами

- Если возникает непредвиденная ошибка, возвращает ошибку

- Иначе, если переменная уже существует в базе данных, обновляет ее

- Если переменной в базе данных не существует, пытается создать ее

==Библиотека Config==

Это те параметры, которые записываются в файл конфигурации config.php.

Это, однако, только с переменные параметров подключения к базе данных.

===Переменные===

====Db_type====

- Тип базы данных (MySQL, PgSQL)

- Тем не менее, поддерживается только MySQL

-'''По умолчанию''': MySQL

====DB_NAME====

- Имя базы данных FreenetIS

-'' 'По умолчанию''': freenetis

====DB_HOST====

- Адрес хоста, на котором будет работать FreenetIS

-'''По умолчанию''': local

====DB_USER====

- Имя пользователя для подключения к базе данных

-'''По умолчанию''': freenetis

====DB_PASSWORD====

- Пароль пользователя для подключения к базе данных

-'''По умолчанию''': freenetis

====Db_table_prefix====

- Префикс для таблиц FreenetIS

- Полезно, если вы ,будете использовать общую базу данных для FreenetIS и для других проектов

-'' 'По умолчанию''': пусто

===Методы===

В отличие от настройки библиотек используется только статический подход:

DB_NAME = $ Config :: get ('db_name')

====Получить====

- Возвращает значение из файла конфигурации, в соответствии с указанным ключом

====Установить====

- Установите нужное значение для указанного ключа

Nastavení

2013-12-10T12:15:57Z

Sivosha:

[[en:Settings]]
[[ru:Настройки]]

Jako každý jiný informační systém i FreenetIS musí mít možnost různých nastavení, jak uživatelských, tak i systémových. V současné době se o to starají dvě knihovny:

application/libraries/settings.php (pro nastavení skrze databázi)
system/core/config.php (pro nastavení skrze konfigurační soubor)

= Původní stav =

V původním stavu framework Kohana podporoval pouze nastavení přes konfigurační soubory, žádné nastavení přes databázi neexistovaly. Z toho plyne, že v systému nešly vytvářet formulář pro nastavení - ty by pak totiž musely tyto soubory přegenerovávat => velké bezpečnostní riziko.

= Současný stav =

Takřka veškerá nastavení byla přesunuta do databáze, v konfiguračním souboru zůstaly pouze přístupové údaje k databázi.

= Samotná implementace =

== Knihovna Settings ==

Všechna nastavení se ukládají do databázové tabulky Config.

=== Proměnné ===

====contact====

====currency====

- měna, které se bude používat v systému

- nastavuje se v Nastavení - Systém - Měna

- '''výchozí hodnota''': CZK

====db_schema_version====

- zřejmě nejdůležitější proměnná - určuje aktuální revizi databázového schématu, používá se pří [[Autoupdate DB struktury]]

- '''nelze nastavit uživatelem v systému, určuje se sama'''

====debtor====
====default_country====
- základní země užívaná v systému (id z tabulky countries)

- '''výchozí hodnota''': 55 (Czech Republic)
====domain====

- doména, na kterém poběží FreenetIS

- pokud je vaše adresa FreenetISu <nowiki>http://www.mojedomena.cz/freenetis/</nowiki>, bude tato proměnná <nowiki>www.mojedomena.cz</nowiki>

- '''výchozí hodnota''': prázdná (pro vytvoření URL se pak používá server::http_host())

====email_default_email====

- výchozí e-mail - na všech e-mailech odeslaných z FreenetISu bude jako odesílatel uvedena tato adresa

- nastavuje se v Nastavení - Systém - Výchozí e-mail

- '''výchozí hodnota''': no-reply@freenetis.org

====email_driver====

- ovladač posílání e-mailu - způsob, jakým se budou odesílat e-maily

- možné možnosti - nativní (pomocí funkce php mail), SMTP a Sendmail

- nastavuje se v Nastavení - E-mail - Ovladač

- '''výchozí hodnota''': nativní

====email_hostname====

- hostitel SMTP serveru

- bere se v potaz, pouze pokud je email_driver nastaven na SMTP

- nastavuje se v Nastavení - E-mail - Název hostitele

- '''výchozí hodnota''': prázdná

====email_port====

- port SMTP serveru

- bere se v potaz, pouze pokud je email_driver nastaven na SMTP

- nastavuje se v Nastavení - E-mail - Port

- '''výchozí hodnota''': 25

====email_password====

- heslo pro přístup na hostitele SMTP serveru

- bere se v potaz, pouze pokud je email_driver nastaven na SMTP

- nastavuje se v Nastavení - E-mail - Heslo

- '''výchozí hodnota''': prázdná

====email_username====

- uživatelské jméno pro přístup na hostitele SMTP serveru

- bere se v potaz, pouze pokud je email_driver nastaven na SMTP

- nastavuje se v Nastavení - E-mail - Uživatelské jméno

- '''výchozí hodnota''': prázdná

====gateway====

====index_page====

- logická proměnná, zda-se má v URL zobrazovat index.php

- 1 => bude se zobrazovat, 0=> nebude se zobrazit

- nastavuje se v Nastavení - Systém - Čistá URL (přes negaci)

- '''výchozí hodnota''': 1

====info====

====interrupt====

====map_google_maps_api_key====

- klíč pro Google maps API, které se v is využívají.

- '''výchozí hodnota''': prázdná

====optional_message====

====payment_notice====

====protocol====

- protokol, na kterém poběží FreenetIS

- pokud je vaše adresa FreenetISu <nowiki>http://www.mojedomena.cz/freenetis/</nowiki>, bude tato proměnná <nowiki>http</nowiki>

- '''výchozí hodnota''': prázdná (pro vytvoření URL se pak používá hodnota http)

====registration_info====

- informace, které se zobrazí na vyexportované přihlášce na horní části

- '''výchozí hodnota''': prázdná

====registration_license====

- licenční podmínky, které se zobrazí na vyexportované přihlášce na dolní části

- '''výchozí hodnota''': prázdná

====self_registration====

- logické proměnná, zda-li povolit samo-registraci zájemců o členství

- nastavuje se v Nastavení - Systém - Samo-registrace

- '''výchozí hodnota''': 1

====suffix====

- přípona za doménou v URL, na které běží FreenetIS

- pokud je vaše adresa FreenetISu <nowiki>http://www.mojedomena.cz/freenetis/</nowiki>, bude tato proměnná <nowiki>/freenetis/</nowiki>

- vždy musí začínat i končit lomítkem (může být i /)

- '''výchozí hodnota''': prázdná (pro vytvoření URL se pak používá substr(server::script_name(),0,-9))

====title====

- titulek stránky, který se zobrazuje v hlavičce (uvnitř HTML atributu title)

- nastavuje se v Nastavení - Systém - Titulek stránky

- '''výchozí hodnota''': FreenetIS

====unknown_device====

====upload_directory====

- určuje adresář, do kterého se budou nehrávat soubory (importy, atd.)

- '''výchozí hodnota:''' upload

====use_javascript====

- logická proměnná, zda-li je používán javascript

- zastaralé, v budoucnu bude odstraněno

- '''výchozí hodnota''': 1

====voip_billing_driver====
- proměnná obsahuje aktuálně zvolený driver pro VoIP

- momentálně je podporovaný pouze drver pro řešení VOIP od NFX z.s.p.o.

- '''výchozí hodnota:''' 0

====voip_billing_partner====

- proměnná obsahuje uživatelské jméno k přihlášení k billingu

- '''výchozí hodnota:''' prázdná

====voip_billing_password====
- proměnná obsahuje uživatelské heslo k přihlášení k billingu

- '''výchozí hodnota:''' prázdná

====voip_number_exclude====
- proměnná obsahuje devíti-místné čísla oddělená středníkem(;)

- čísla uvedená v tomto seznamu nebudou nabídnuta k výberu pro registraci VoIP účtu

- '''výchozí hodnota:''' prázdná

====voip_number_interval====
- proměnná obsahuje rozsah devítimístných čísel ve tvaru XXXXXXXXX-XXXXXXXXX

- čísla uvedená v tomto seznamu budou nabídnuta k výbeřu pro registraci VoIP ůčtu

- '''výchozí hodnota:''' prázdná

====voip_sip_server====
- proměnná uchovává řetezec s hostname SIP serveru. Např. sip.slfree.czf

- zobrazuje se v nastavení VoIP účtu jako doplňující informace. Nemá vliv na funkci ústředny.

- '''výchozí hodnota''': prázdná

====website_after_redirection====

===Metody===

Celá knihovna obsahuje pouze dvě metody - set a get.

V kontrolerech a v pohledech (ve views) se používá dynamický přístup - v záhlaví hlavního kontroleru se vytvoří instance knihovny:

$this->settings = new Settings();

a pak např. hodnotu proměnné suffix získáme takto:

$this->settings->get('suffix');

V ostatních místech aplikace (helpers, atd.) se pak musí používat statický přístup:

$suffix = Settings::get('suffix');

====get====

- vrací hodnotu podle zadaného klíče

- pokud nalezne neprázdnou hodnotu, vrátí ji

- pokud nalezne prázdnou hodnotu nebo nestane neočekávaná chyba, zkontroluje, zda-li existuje stejnojmenný privátní atribut (tj. defaultní hodnota)

- pokud existuje, vrátí jej

- pokud neexistuje, zkusí vrátit stejnojmennou proměnnou z Configu (z konfiguračního souboru)

====set====

- nastaví proměnnou zadanou pomocí klíče na zadanou hodnotu

- pokud nastane neočekávaná chyba, vrátí neúspěch

- jinak pokud proměnná již v databázi existuje, aktualizuje ji

- pokus proměnná v databázi neexistuje, vytvoří ji

== Knihovna Config ==

Jedná se o nastavení, které se zapisují do konfiguračního souboru config.php.

Jde však pouze o proměnné s údaji pro připojení k databázi.

===Proměnné===

====db_type====

- typ databáze (mysql, pgsql)

- zatím je podporováno pouze mysql

- '''výchozí hodnota''': mysql

====db_name====

- název databáze, na které poběží FreenetIS

- '''výchozí hodnota''': freenetis

====db_host====

- adresa hostitele, na kterém poběží FreenetIS

- '''výchozí hodnota''': localhost

====db_user====

- uživatelské jméno pro připojení k databázi

- '''výchozí hodnota''': freenetis

====db_password====

- uživatelské heslo pro připojení k databázi

- '''výchozí hodnota''': freenetis

====db_table_prefix====

- předpona pro tabulky FreenetISu

- užitečné, pokud chcete používat společnou databázi pro FreenetIS a jiný projekt

- '''výchozí hodnota''': prázdná

===Metody===

Na rozdíl od knihovny Settings se u této knihovny používá pouze statický přístup:

$db_name = Config::get('db_name')

====get====

- vrací hodnotu z konfiguračního souboru podle zadaného klíče

====set====

- nastaví zadanou hodnotu na zadaný klíč

I18n (english)

2013-12-10T12:14:24Z

Sivosha:

[[cs:I18n]]
[[ru:I18n (русский)]]

Internationalization in FreenetISu covers two areas:
* Strings that are contained in the source code - this is done using the language files in i18n
* Strings in the database - string in the database is usually not necessary to translate. The exceptions are enumerated types - eg types of members, facilities, contacts that you can edit through a web interface. Since the installation Freenetis contains basic values for these types, it is necessary for them to think about internationalization.

Enumerated types are implemented using two tables:

{| Border = "1" class = "wikitable"
| + Enum_types:
! id! type_id! value
| -
| 1 | | 1 (eg type = member) | | Applicant
| -
| 2 | | 1 | | Regular member
| -
| 3 | | 1 | | Honorary member
| -
| 4 | | 2 (eg = contact type) | | Phone
| -
| 5 | | 2 | | ICQ
| -
| 6 | | 2 | | Skype
|}
Table enum_types contains a listing of all types in the default language (here English is selected)

Translations for each row of enum_types we obtain from the table translations:

{| Border = "1" class = "wikitable"
| + Translations:
! id! original_term! translated_term! lang
| -
| 1 | | Regular member | | Řádný člen | | cs
| -
| 2 | | Regular member | | Regular member | | en
| -
| 3 | | Regular member | | ordentlich Mitglied | | de
| -
| 4 | | Phone | | Phone | | cs
| -
| 5 | | Phone | | Phone | | de
| -
|}

Due to the fact that both tables are interrelated by key, you can use the table translations and translation of terms from other tables than enum_types.

Common query to get id and the corresponding strings for a particular language types of members (type_id = 1):

SELECT enum_types.id, IFNULL(translations.translated_term,enum_types.value) as value FROM enum_types
LEFT JOIN translations on enum_types.value = translations.original_term
WHERE enum_types.type_id=1 AND translations.lang="cs"

I18n (русский)

2013-12-10T12:13:32Z

Sivosha: Založena nová stránka: cs:I18n en:I18n (english) Интернационализация в FreenetISu охватывает две области: * Строки, которые соде...

[[cs:I18n]]
[[en:I18n (english)]]

Интернационализация в FreenetISu охватывает две области:
* Строки, которые содержатся в исходном коде - это делается с помощью языковых файлов в i18n
* Строки в базе данных - строки в базе данных, как правило, не нужно переводить.Исключение - названия типов - например, типы членов, объектов, контакты, которые вы можете редактировать через веб-интерфейс. С момента установки Freenetis содержит основные значения для этих типов, необходимо было бы подумать и об их интернационализации.

Перечисляемые типы реализуются с помощью двух таблиц:

{| border = "1" class= "wikitable"
| + Enum_types:
! ID! TYPE_ID! значение
| -
| 1 | | 1 (например, тип пользователя =) | | заявитель
| -
| 2 | | 1 | | постоянный член
| -
| 3 | | 1 | | Почетный член
| -
| 4 | | 2 (= в качестве контактного типа) | | телефон
| -
| 5 | | 2 | | ICQ
| -
| 6 | | 2 | | Skype
|}
Таблица enum_types содержит перечень всех типов на языке по умолчанию (здесь выбран английский язык)

Переводы для каждой строки enum_types получаем из таблицы переводы:

{| Border = "1" class = "wikitable"
| + Translations:
! id! original_term! translated_term! lang
| -
| 1 | | Regular member | | Řádný člen | | cs
| -
| 2 | | Regular member | | Regular member | | en
| -
| 3 | | Regular member | | ordentlich Mitglied | | de
| -
| 4 | | Phone | | Phone | | cs
| -
| 5 | | Phone | | Phone | | de
| -
|}

В связи с тем, что обе таблицы взаимосвязаны через ключ, вы можете использовать таблицу переводы и перевод терминов из других таблиц вместо enum_types.
SELECT enum_types.id, IFNULL(translations.translated_term,enum_types.value) as value FROM enum_types
LEFT JOIN translations on enum_types.value = translations.original_term
WHERE enum_types.type_id=1 AND translations.lang="cs"

I18n

2013-12-10T12:12:34Z

Sivosha:

[[en:I18n (english)]]
[[ru:I18n (русский)]]

Internacionalizace ve FreenetISu se týká 2 oblastí:

* řetězců, které jsou obsaženy ve zdrojových kódech - tato se provádí pomocí jazykových souborů v adresáři i18n
* řetězců v databázi - řetězce v databázi není ve většině případů nutné překládat. Výjimkou jsou výčtové typy - např. typy členů, zařízení, kontaktů, které lze editovat i přes webové rozhraní. Protože instalace Freenetis-u obsahuje základní hodnoty pro tyto typy, bylo nutné pro ně vymyslet i internacionalizaci.

Výčtové typy jsou implementovány pomocí 2 tabulek:

{| border="1" class="wikitable"
|+ enum_types:
! id !! type_id !! value
|-
| 1 || 1 (=např. typ člena) || Applicant
|-
|2 || 1 || Regular member
|-
|3 || 1 || Honorary member
|-
|4 || 2 (=např. typ kontaktu) || Phone
|-
|5 || 2 || ICQ
|-
|6 || 2 || Skype
|}
Tabulka enum_types obsahuje výpis všech typů v defaultním jazyce (zde je zvolena angličtina)

Překlady k jednotlivým řádkům z enum_types budeme získávat z tabulky translations:

{| border="1" class="wikitable"
|+ translations:
! id !! original_term !! translated_term !! lang
|-
| 1 || Regulary member || Řádný člen || cs
|-
| 2 || Regulary member || Regular member || en
|-
| 3 || Regulary member || Ordentlich Mitglied || de
|-
| 4 || Phone || Telefon || cs
|-
| 5 || Phone || Telefon || de
|-
|}

Díky faktu, že obě tabulky nejsou provázané klíči, můžeme použít tabulky translations i na překlady termínů z jiných tabulek než enum_types.

Běžný dotaz pro získání id a jemu odpovídajícího řetězce určitého jazyka pro typy členů (type_id=1):

SELECT enum_types.id, IFNULL(translations.translated_term,enum_types.value) as value FROM enum_types
LEFT JOIN translations on enum_types.value = translations.original_term
WHERE enum_types.type_id=1 AND translations.lang="cs"

Economy

2013-12-10T12:11:19Z

Sivosha:

[[cs:Ekonomika]]
[[ru:Экономика]]

= Introduction =
Evidence of contributions is a typical problem for the double-entry bookkeeping. Why? Because [http://en.wikipedia.org/wiki/Double-entry_bookkeeping_system#Timeline at 12.-13. century, when the double-entry first appeared in written mentions,  yet nobody could think of no better and simpler system of internal financial records for any entity (sole trader, NGO, company or a university ...).

The principle of double-entry bookkeeping is really trivial: for every financial transaction you are getting is of the form

______________________ Amount ____________________
| source binary Account | ----------> | target binary Account |
| __________________ | | _________________ |

Eg. when Franta Siska send being matched by amount of CZK 1,000, it can be dually accounted as follows:

______________________ 1000 Kč ____________________
| Franta Siska | ---------->| our bank account |
|_____________________| |________________|

or like this:
______________________ 1000 CZK ____________________
| Member contributions | ----------> | Credit Franta Siska |
| _________________ | | _______________ |

Note: what is the second way of account "membership fees"?

Money in the double-entry account can not come from "nowhere", on both sides of the arrow must be some bills.

The advantage of this is that if we all membership fees transferred to one account "Мembership fees" the current state of this account say how many of contributions we chose. Account balance is obtained with a single query in style:
SELECT balance FROM accounts WHERE accounts.name="Мembership fees".

= DB Schema =
With double-entry accounts we can open up the required accounts

Example: You want to know how much we spend for UTP cables. Therefore create account "UTP cables" and it will convert the amount of each purchase of UTP cable.

In FreenetIS double bills stored in a '''table accounts'''.

After installing FreenetISu accounts table contains only about 5 bills, but over time their numbers are growing, because every paying member is automatically created "his" double account, on which stores his funds.

In FreenetISu member can assigned other double-entry accounts - these are accounts of projects, but about that next time.

Transfers between accounts are double-entry '''table''' '''transfers'''. Its columns are :
* Origin_id , destination_id : id accounts from the table Accounts
* Previous_transfer_id : used in complex transactions that consist of multiple transfers. Eg . posting invoices are normally makes two transactions. To make it clear that these two transactions "belong together" previous_transfer_id in the second point to the first transaction.
* Member_id : ID user from which account originates deal. It may seem that this column is not necessary, because in each user's account is also listed member_id.. But keep member_id and transfers in the table is useful in multi- step transfers . Eg . accounting for payment of the membership fee in our association we do in 5 transfers , only one of which targets a credit account member. We want to simply see that the other transfers "caused" this particular member - we could deduce although complicated over previous_transfer_id , but the question , it would be crazy.
* User_id : user id , which created a binary transfer . In FreenetISu the right of access to economic assign more people so it is important to know which one of them committed the transfer .
* Type: 1 = regular monthly contribution , 2 = initial contribution , 4 = recharge VOIP credit ...
* Datetime : date and time of the transaction. Eg . in online banking statement will indicate these date and time. The invoice date there will be a taxable transaction.
* Creation_datetime : date and time when the transfer was entered into FreenetISu
* Text , Amount - description of payment and amount

Note for experts of double-entry bookkeeping: table transfers is actually common accounting journal - the same as my grandfather 50 years ago led on the paper ...

==Table account_attributes==
Speaking thus dually account is a good idea to have our double bills "compatible" with the legislation of our country.

Then the binary states of accounts in FreenetIS instantly start using the pan (s) accounts our organization, because his (her) it saves a lot of work.

To achieve the compatibility of the legislation for each double counting account is necessary to find an appropriate accounting standard account in accordance with the law.

Standard accounts legislation defines as the chart of accounts (Britons have a better term: chart of accounts).

The chart of accounts is a list of possible accounts for the type of organization. For each account in the chart of accounts is defined its standard name, standard number and other attributes.

The chart looks like for nonprofits, a little different for businesses, a little different for government.

In FreenetIS chart of accounts is stored in a table account_attributes as a chart of accounts for non-profits.  Other types of charts of accounts (eg business) to deal with installer FreenetIS, but so far nobody wanted.

We probably most interested in which standart accounts will be mapped credit members' accounts?

The dual credit account can be a member by the chart of accounts for non-profit organizations to implement either
# Sub-standard account "membership fees" (standard number in the chart of accounts = 684,000)
# Sub-standard account "Bank Accounts" (No. 221000)

In FreenetISu use the second option because it is the same for nonprofits as well as for other entities whose financial chart of any membership fees (684,000) do not know.

More detailed explanation can be found in this presentation:
* [Http://zamestnanci.fai.utb.cz/ ~ dulik/unart/hospodareni_v1_5.pdf PDF format]
* [Http://zamestnanci.fai.utb.cz/ ~ dulik/unart/hospodareni_v1_5.odp ODP format]

On slide 13 is shown how the membership fees will be charged in UnArtu (Imported from EBANKA).

=== Types double-entry accounts used when importing from the bank ===

* Account_attribute_Model :: MEMBER_FEES - type "membership dues"
* Account_attribute_Model :: SUPPLIERS - type "contractors"
* Account_attribute_Model :: OPERATING - operating account into which all fall uncategorized revenues and expenses Association
* Account_attribute_Model :: CASH - account for cash payments (cash)

== Evidence bank accounts ==
Unlike conventional accounting systems (Pohoda, Money S3) FreenetIS has a better record of bank accounts of members - FreenetIS allows you to keep track of each member to its bank accounts. It often helps us to identify payments with poor variability - although many members (= families) pay the wife's bank account, which bears her maiden name (different from the surname of the family), we are able to register through bank accounts instantly know which member is the originator such payments.

Bank accounts recorded in the table'' 'bank_accounts'''.

After installation FreenetIS there will be only bank account of the association.

Other members of the bank accounts automatically creates by import from ebank. For payments that are proper of variable, also importer newly generated by banks. account automatically assigns the owner.

If you want to import bank statements that does not contain bank accounts, then you will have to create account in the table "bank_accounts" as "unidentified"

Why? See the next chapter:

== Evidence of bank statements ==
Bank statements recorded in the table '''bank_statement'''.

Each bank statement consists of many banking transactions.
Banking transactions are transfers between bank accounts.
Therefore, we record similar to the double-entry transfers between accounts - using the table '''bank_transfers''', which contains the following columns:
* Origin_id, destination_id: id bank accounts of the table bank_accounts
* Transfer_id: id double-entry transfer of table transfers. Each bank transfer should be dually recognized ie refer to a double-entry transfer. If you did not recognize some bank transfers, there will be accounting error - status of double-entry account "bank account" will not sit with the actual state bank account
* Bank_statement_id link to a table of banks
* Number: Line number or number of the item bank listing
* Variable_symbol, constant_symbol, specific_symbol - it is probably clear
* Comment - any comment on the accounting for a payment

Date, time and text payments, we decided not to record in this table, but in the table transfers - because every bank_transfer has always assigned a transfer, they would have the same name, the columns in the table bank_transfers redundant.

= Terminology =
* The code uses a mixture of English "simply stated" and the official accounting terminology.
* Official English and the corresponding Czech accounting terminology is described
In this ** [http://ofirme.info/ofirmeinfo/frame3/zakazky/banka/1/Czech-English% 20Dictionary.doc glossary]
PhD work in ** Radek Vogel MUNI Brno].

= Import bank statements =
FreenetIS currently can import HTML listings of ebanka / Raiffeisen banks and any listings in CSV format.
The largest part of the work in this area represent parsers - especially HTML parser ebanka. Therefore parsers are written so that they have no dependency on the framework Kohana nor FreenetISu - they are completely separate library.

Description of the implementation of the following articles:
* [[Preparation for the data import]]
* [[Raiffeisenbank]]
* [[Fio banka]]
* [[Saving data to the database]]

Экономика

2013-12-10T12:10:21Z

Sivosha: Založena nová stránka: cs:Ekonomika en:Economy = Введение = Подтверждение членских взносов является типичной проблемой для...

[[cs:Ekonomika]]
[[en:Economy]]

= Введение =
Подтверждение членских взносов является типичной проблемой для двойной бухгалтерии. Почему? Потому что http://en.wikipedia.org/wiki/Double-entry_bookkeeping_system# Приблизительно в 12.-13. веке, когда двойная запись впервые появился в письменных упоминаниях,  еще никто не cмог придумать лучшей и более простой системы внутренней финансовой отчетности для любого субъекта (индивидуального предпринимателя, НПО, компания или университет ...).

Принцип двойной бухгалтерии довольно прост: для каждой финансовой сделки он имеет вид

______________________ Количество ____________________
|Счет-источник | ----------> | Счет-получатель|
| ___________ | | ______________ |

Например. когда Франта Сиска, печислит ассоциации 1000 крон, то это может отражаться следующим образом:

______________________ 1000 крон ____________________
| Franta Siska | ----------> | Наш счет в банке|
| ______________________ | | ______________ |

Или вот так:
______________________ 1000 крон ____________________
| Клиентское извещение | ----------> | Кредит Franta Siska |
| ___________________ | | _______________ |

Примечание: что означает во втором способе учета "клиентское извещение"?

Деньги при двойной записи не могут поступить из “ниоткуда”. Учет должен вестись с обеих сторон.

Преимущество такой запис в том, что если все членские взносы перечисляются на счет "Членские взносы" то текущее состояние этого счета показывает, сколько взносов мы собрали. Баланс счета получается с помощью одного запроса в стиле:
SELECT balance FROM accounts WHERE accounts.name="Членские взносы".

= DB схема =
При двойном учете мы сами можем открывать нужные счета

Пример: Вы хотите знать, сколько тратите на кабели UTP. Создайте счет "UTP кабели" на котором будут накапливаться все суммы каждой покупки кабеля UTP.

В FreenetIS двойные счета, хранятся в '''таблице счетов'''.

После установки FreenetISu счетов таблица содержит лишь около 5 счетов, но со временем их число растет, потому что каждый платящий пользователь автоматически создает "свой" двойной счет, на ктором хранятся его срадства.

В FreenetISu пользователь может открыть другой счет двойной записи - это счета проектов, но об этом в следующий раз.

Переводы между счетами двойной записи хранятся в '''таблице''' '''переводв'''. Ее столбцы :
* Origin_id , destination_id : ID счетов из таблицы счетов
* Previous_transfer_id : ID предыдущей транзакции в сложных операциях, состоящих из нескольких транзакций. Например, движение средств по счету-фактуре отображается двумя транзакциями. Чтобы было понятно, что эти две сделки "должны быть вместе " , установленный во второй транзакции previous_transfer_id и указывать на первую .
* Member_id : ID пользователя, со счета которого берет свое начало сделка . Может показаться, что эта колонка не нужна, потому что в каждом счете пользователя также указан member_id . Но наличие member_id в таблице переводов полезно при многоступенчатой передачи. Например, учета оплаты членского взноса в нашей ассоциации выполняется пятью транзакциями, из которых только в одной присутствует счет пользователя. Мы хотим увидеть, что другие транзакции тоже "вызваны" этим конкретным членом - мы могли бы это выяснить более сложным путем через previous_transfer_id.
* User_id : ID пользователя , который создал эту операцию . В FreenetISu право доступа к экономической части может иметь много людей , поэтому важно знать , кто из них совершил передачу.
* type: 1 = Регулярный ежемесячный взнос , 2 = первоначальный взнос , 4 = пополнения VOIP кредит ...
* datetime : дата и время совершения операции. Например . в банковской он-лайн выписке будут указаны эти дату и время. Дата выставления счета связана с налогооблагаемой операцией .
* Creation_datetime : дата и время , когда передача была введена в FreenetISu
text, amount - назначение платежа и сумма

Специалисты бухгалтерии, обратите внимание,: Таблица переводов на самом деле это общий журнал учета - такой же, как мой дед 50 лет назад вел на бумаге ...

==Таблица account_attributes==
Раз уже зашла речь о двойно учете, то неплохо бы выяснить его "совместимость" с законодательством нашей страны.

Использование Вами счетов двойного учета во FreenetIS дает Вам большую экономию во времени.

Для достижения совместимости системы с законодательством для каждого счета двойного учета необходимо найти соответствующий счет стандартного учета в соответствии с законодательством.

Стандартный учет согласно законодательству предусматривает использование т.н. план счетов.

План счетов представляет собой перечень возможных счетов двойного учета в организации. Для каждого счета в плане счетов определяется его стандартное имя, номер и другие атрибуты.

План счетов для некоммерческих организаций мало чем отличается для бизнеса, немного отличается для правительства.

В FreenetIS план счетов хранится в таблице account_attributes как план счетов для некоммерческих организаций. Другие виды планов счетов (например, бизнес) предусмотрены в инсталяции FreenetIS, но до сих пор не были востребованы.

Больше всего интересует с каким стандартным учетом будут связаны кредитные счета.

Двойной кредитный счет может быть членом по плану счетов для некоммерческих организаций для реализации либо
# Субстандартный счет "членские взносы" (стандартный номер в план счетов = 684000)
# Субстандартный счет "банковских счетов" (№ 221000)

В FreenetIS используется второй вариант, потому что он одинаков как для некоммерческих организаций, так и для других лиц,

Более подробное описание можно найти в этой презентации:
* [Http :/ / zamestnanci.fai.utb.cz / ~ dulik/unart/hospodareni_v1_5.pdf в формате PDF]
* [Http :/ / zamestnanci.fai.utb.cz / ~ dulik/unart/hospodareni_v1_5.odp в формате ODP]

На слайде 13 показано, как членские взносы будут взиматься в UnArtu (импорт из EBANK).

===Типы счетов двойного учета, используемые при импорте из банка ===

* Account_attribute_Model :: MEMBER_FEES - тип "членские взносы"
* Account_attribute_Model :: SUPPLIERS - тип "подрядчики"
* Account_attribute_Model :: OPERATING - операционные счета, на которые поступают все некатегоризованные платежи доходов и расходов Ассоциации
* Account_attribute_Model :: CASH - счета для денежных выплат (наличными)

== Контроль банковских счетов ==
В отличие от обычных систем учета (Pohoda, Money S3) FreenetIS лучше контролирует показатели банковских счетов членов - FreenetIS позволяет отслеживать все банковские счета каждого члена. Это часто помогает нам определить платежи с неточными или запутанными данными - многие члены (=семей) платят банку со счета жены, который зарегистррован на ее девичью фамилию (отличается от фамилии семьи). мы можем через зарегистрированные банковские счета сразу узнать, членом какой семьи является создатель таких платежей.

Банковские счета записываются в таблицу'' 'bank_accounts'''.

После установки FreenetIS в таблице будет только банковский счет Ассоциации.

Другие записи банковских счетов создаются при импорте из е-банка. В платежах с правильными реквизитами а также сгенерированных при импорте счетам автоматически определяется владелец.

Если вы хотите импортировать банковские выписки, которые не содержат банковские счета, то вам придется в таблице "bank_accounts" создавать счета как "неизвестные"

Почему? Читайте в следующей главе:

== Подтверждение банковских выписок ==
Выписки из банковских счетов заносятся в таблицу '''bank_statement'''.

Каждая банковская выписка состоит из различных банковских операций.
Банк проводит операции между банковскими счетами.
Таким образом, мы записываем в виде двойной записи переводов между счетами - с помощью таблицы '''bank_transfers''', которая содержит следующие столбцы:
* Origin_id, destination_id: ID банковских счетов таблицы bank_accounts
* Transfer_id: ID записи таблицы переводов. Каждый банковский перевод должен быть идентифицирован дважды т.е. соответствовать к двойной записи. Если Вы не идентифицируете некоторые банковские переводы, будет ошибкой учета - статус двойной записи счета “банковский счет” не будет соответствовать фактическому состоянию банковского счета
* Bank_statement_id ссылка на таблицу банков
* Number: номер строки или номер пункта списка банков
* Variable_symbol, constant_symbol, specific_symbol - это, вероятно, ясно
* Примечание - любой комментарий по учету оплаты

Дата, время и текст платежей мы решили записывать не в этой таблице, а в таблиц переводов - потому что каждый bank_transfer всегда соответствует переводу, они имели бы то же имя, столбцов в таблице bank_transfers.

= Терминология =
* Код использует смесь английского "Проще говоря" и официальную бухгалтерскую терминологию.
* Соответствие официальной английской и чешской бухгалтерской терминологии описывается здесь ** [http://ofirme.info/ofirmeinfo/frame3/zakazky/banka/1/Czech-English% 20Dictionary.doc glossary]
PhD work in ** Radek Vogel MUNI Brno].

= Выписки других банков =
FreenetIS в настоящее время может импортировать выписки HTML ebanka / Райффайзен банка и записей в формате CSV.
Большая часть работы в этой области выполняют анализаторы - особенно HTML парсер ebanka. Поэтому анализаторы написаны так, что они не имеют зависимость от фреймворка Kohana или FreenetIS - это полностью отдельные библиотеки

В следующих статьях описано:
* [[Подготовка к импорту данных]]
* [[Райффайзенбанк]]
* [[Fio банка]]
* [[Сохранение данных в базу данных]]

Ekonomika

2013-12-10T12:09:28Z

Sivosha:

[[en:Economy]]
[[ru:Экономика]]

= Úvod =
Evidence členských příspěvků je typická úloha pro podvojné účetnictví. Proč?Protože [http://en.wikipedia.org/wiki/Double-entry_bookkeeping_system#Timeline od 12.-13. století, kdy se podvojné účto poprvé objevuje v písemných zmínkách],  ještě nikdo nevymyslel žádný lepší a jednodušší systém vnitřní evidence financí pro jakýkoli subjekt (živnostník, neziskovka, s.r.o nebo univerzita...).

Princip podvojného účetnictví je opravdu triviální: o každé finanční operaci si pořizujete záznam ve tvaru

______________________    částka    ____________________
|zdrojový podvojný účet| ---------->|cílový podvojný účet|
|______________________|            |____________________|

Např. když Franta Šiška pošle sdružení částku 1000 Kč, lze to podvojně zaúčtovat takto:

______________________ 1000 Kč ____________________
| Franta Šiška | ---------->| náš bankovní účet |
|______________________| |____________________|

anebo třeba takto:
______________________    1000 Kč   ____________________
| Členské příspěvky   | ---------->|Kredit Franta Šiška |
|______________________|            |____________________|

Poznámka: k čemu je ve druhém způsobu účet "Členské příspěvky"?

Peníze v podvojném účtu nemůžou přitéct "odnikud", na obou stranách šipky musí být nějaké účty.

Výhoda tohoto je v tom, že když budeme všechny členské příspěvky převádět z jednoho účtu "Členské příspěvky", bude nám okamžitý stav tohoto účtu říkat, kolik členských příspěvků už jsme vybrali. Stav účtu získáme jediným dotazem ve stylu:
SELECT balance FROM accounts WHERE accounts.name="Členské příspěvky".

= DB Schema =
Podvojné účty si můžeme v podvojném účetnictví tvořit dle vlastní libovůle.

Příklad: chceme zjistit, kolik utrácíme za UTP kabely. Vytvoříme si proto účet "UTP kabely" a na něj budeme převádět částku z každého nákupu UTP kabelu.

Ve FreenetISu jsou podvojné účty, které naše organizace používá, uloženy v '''tabulce accounts'''.

Po instalaci FreenetISu tabulka accounts obsahuje jenom cca 5 účtů, ale s postupem času jejich počet roste, protože každý platící člen má automaticky vytvořen "svůj" podvojný účet, na kterém ukládáme jeho kredit.

Ve FreenetISu může člen mít přiřazeny i další podvojné účty - to jsou účty projektů, ale o tom někdy příště.

Převody mezi podvojnými účty jsou v '''tabulce''' '''transfers'''.Její sloupce jsou:
* origin_id, destination_id : id podvojných účtů z tabulky accounts
* previous_transfer_id : používá se u složitějších podvojných transakcí, které se skládají z více podvojných převodů. Např. zaúčtování faktury se standardně dělá 2ma transakcemi. Aby bylo jasné, že tyto 2 transakce "patří k sobě", nastavíme u té druhé previous_transfer_id tak, aby ukazovalo na tu první transakci.
* member_id : u platby příspěvku je zde ID člena, od něhož transakce pochází. Může se zdát, že tento sloupec je zbytečný, protože peníze přece putují na kreditní účet člena a ten má také údaj member_id. Ale držet si member_id i v tabulce transfers je výhodné při více-krokových převodech. Např. zaúčtování platby členského příspěvku v našem sdružení děláme v 5ti podvojných převodech, z nichž jen jeden cílí na kreditní účet člena. My ale chceme jednoduše vidět, že i ty ostatní převody "způsobil" tento daný člen - mohli bychom to sice složitě odvodit přes previous_transfer_id, ale ten dotaz, to by byla šílenost.
* user_id : id uživatele, který podvojný převod vytvořil. Ve FreenetISu můžete právo přístupu k ekonomické části přidělit více lidem, takže je potřeba vědět, kdo z nich daný převod spáchal.
* type: 1=stržení pravidelného měsíčního příspěvku, 2=vstupní příspěvek, 4=dobití VOIP kreditu, ...
* datetime: datum a čas účetního případu. Např. u řádku bankovního výpisu se zde bere datum a čas tohoto řádku. U faktury zde bude datum zdanitelného plnění.
* creation_datetime: datum a čas, kdy byl převod zadán do FreenetISu
* text, amount - popis platby a částka

Pozn. pro znalce podvojného účetnictví: tabulka transfers je vlastně obyčejný účetní deník - stejný, jaký si můj děda před 50ti lety vedl v papírové podobě...

== Tabulka account_attributes ==
Když už tedy podvojně účtujeme, je dobrý nápad mít naše podvojné účty "kompatibilní" s legislativou našeho státu.

Pak může stavy podvojných účtů ve FreenetISu okamžitě začít využívat pan(í) účetní naší organizace, protože mu (jí) to ušetří spoustu práce.

Abychom dosáhli kombatibilitu s legislativou, musíme ke každému našemu podvojnímu účtu najít nějaký standardní účet dle legislativy.

Standardní účty legislativa definuje ve formě tzv. účetní osnovy (angličani mají lepší termín: chart of accounts).

Účetní osnova je seznam možných podvojných účtů  pro daný typ organizace. U každého účtu je v účetní osnově definován jeho standardní název, standardní číslo a další atributy.

Účetní osnova vypadá nějak pro neziskovky, trochu jinak pro podnikatelské subjekty, trochu jinak pro státní správu.

Ve FreenetISu je účetní osnova uložena v tabulce account_attributes, a to jako účetní osnova pro neziskovky.  Jiné typy účetních osnov (např. podnikatelské) by řešil instalátor FreenetISu, ale zatím to nikdo nechtěl.

Nás asi nejvíc zajímá, na který standardní podvojný účet budeme mapovat kreditní účty členů?

Podvojný účet kreditu člena můžeme dle účetní osnovy pro neziskovky implementovat buď jako
# podúčet standardního účtu "Členské příspěvky" (standardní číslo v účetní osnově = 684000)
# podúčet standardního účtu "Účty v bankách" (číslo 221000)

Ve FreenetISu používáme 2. variantu, protože je stejná pro neziskovky i pro jiné subjekty, jejichž účetní osnova žádné členské příspěvky (684000) nezná.

Podrobnější výklad  najdete v této prezentaci:
* [http://zamestnanci.fai.utb.cz/~dulik/unart/hospodareni_v1_5.pdf formát PDF]
* [http://zamestnanci.fai.utb.cz/~dulik/unart/hospodareni_v1_5.odp formát ODP]

Na slajdu 13 je ukázán způsob, jakým členské příspěvky účtujeme v UnArtu my (při importu z Ebanky).

=== Typy podvojných účtů používaných při importu z banky ===

*Account_attribute_Model::MEMBER_FEES - typ "členské příspěvky"
*Account_attribute_Model::SUPPLIERS - typ "dodavatelé"
*Account_attribute_Model::OPERATING - operační účet, do kterého padají všechny nekategorizované příjmy a výdaje sdružení
*Account_attribute_Model::CASH - účet pro platby v hotovosti (pokladna)

== Evidence bankovních účtů ==
Narozdíl od běžných účetních systémů (Pohoda, Money S3), má FreenetIS dokonalejší evidenci bankovních účtů členů - FreenetIS umožňuje evidovat u každého člena až N jeho bankovních účtů. To nám velmi často pomáhá při identifikaci platby se špatným variabilem - přestože spousta členů(=rodin) platí z bankovního účtu manželky, který nese její dívčí příjmení (odlišné od příjmení rodiny), jsme schopni díky evidenci bankovních účtů okamžitě poznat, který člen je původcem takové platby.

Bankovní účty evidujeme v tabulce '''bank_accounts'''.

Po instalaci FreenetISu zde bude pouze bankovní účet sdružení.

Další bankovní účty členů automaticky vytváří  importer z ebanky. U plateb, které mají správný variabil, také importer nově vytvářenému bank. účtu automaticky přiřadí majitele.

Pokud chcete importovat bankovní výpisy ze zdroje, který bankovní účty neobsahuje, pak budete muset v tabulce "bank_accounts" vytvořit účet "NEIDENTIFIKOVANY"

Proč? Viz další kapitola:

== Evidence bankovních výpisů ==
Bankovní výpisy evidujeme v tabulce '''bank_statement'''.

Každý bankovní výpis sestává z mnoha bankovních transakcí.
Bankovní transakce jsou převody mezi bankovními účty.
Proto je  evidujeme podobně, jako převody mezi podvojnými účty - pomocí tabulky '''bank_transfers''', která obsahuje následující sloupce:
* origin_id, destination_id : id bankovních účtů z tabulky bank_accounts
* transfer_id : id podvojného převodu z tabulky transfers. Každý bankovní převod by měl být podvojně zaúčtovaný, tj. odkazovat na některý podvojný převod. Pokud byste některé bankovní převody nezaúčtovali, vznikne účetní chyba - stav podvojného účtu "bankovní účet" nebude sedět se skutečným stavem bankovního účtu
* bank_statement_id : odkaz do tabulky bank
* number: Line number or number of the bank listing item   
* variable_symbol,   constant_symbol, specific_symbol - to je asi jasné
* comment - případný komentář účetního k dané platbě

Datum, čas a text platby jsme se rozhodli evidovat ne v této tabulce, ale v tabulce transfers - protože každý bank_transfer má vždy přiřazen jeden transfer, byly by stejnomenné sloupce v tabulce bank_transfers redundantní.

=Terminologie=
*V kódu se používá směska anglické "polopatické" a oficiální účetní terminologie.
*Oficiální anglická a jí odpovídající česká účetní terminologie je popsána
**V tomto [http://ofirme.info/ofirmeinfo/frame3/zakazky/banka/1/Czech-English%20Dictionary.doc slovníčku]
**v PhD práci [http://is.muni.cz/th/33061/ff_d/Radek_Vogel_-_Lexical_Hierarchies_in_the_Scientific_Terminology_-_doctoral_thesis_2006.doc Radka Vogela z MUNI Brno].

=Import výpisů z banky=
FreenetIS momentálně umí importovat HTML výpisy z ebanky/Raiffeisen banky a výpisy v libovolném CSV formátu.
Největší díl práce v této oblasti představují parsery - především HTML parser ebanky. Proto jsou parsery napsány tak, aby neměly žádnou závislost na frameworku Kohana ani na FreenetISu - jsou to naprosto samostatné knihovny.

Popis implementace je v následujících článcích:
* [[Příprava pro import dat]]
* [[Raiffeisenbank]]
* [[Fio banka]]
* [[Ukládání dat do databáze]]

Технические условия

2013-12-10T12:06:21Z

Sivosha: Založena nová stránka: cs: Specifikace en: Specifications == FreenetIS 1.0 == [http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/branches/qcodo/wwwroot/doc/FreeNetIS-speci...

[[cs: Specifikace]]
[[en: Specifications]]

== FreenetIS 1.0 ==

[http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/branches/qcodo/wwwroot/doc/FreeNetIS-specifikace_v_0-6.pdfПо умолчанию] спецификация, которая была использована для двух диссертаций и основывалась на других разработчиках. Данная спецификация, но в настоящее время действующая. Там было много изменений, например платежи в конечном итоге были решены и реализованы совершенно по-разному.

Диссертации, в результате реализации основных членов и платежей.
* [http://zamestnanci.fai.utb.cz/~dulik/diplomky/2007-2008/Danek-MVC-Freenetis.pdf DP Petra Daňka]
Диссертации, в результате реализации основного оборудования.
* [http://zamestnanci.fai.utb.cz/~dulik/diplomky/2007-2008/Rozehnal-MVC-freenetis.pdf DP Marka Rozehnala]

Документация для дальнейшего расширения и модификации системы была создана другими программистами, может быть найдена только на этой вики или непосредственно в исходном коде.

Вводная презентация по реализации экономики:
*[[Media:Hospodareni.odp|formát ODP]]
*[[Media:Hospodareni.pdf|formát PDF]]

Девиз FreenetIS 2 "система без компромиссов" - то есть, мы хотим избежать компромиссных решений которые мы сделали в FreenetIS 1 и сегодня мы дорого расплачиваемся за это все большим числом компромиссов.

Весь FreenetIS должны быть созданы в Java EE.

===Схема базы данных===

Примечание: Чтобы нарисовать ER диаграммы, есть несколько проектов с открытым кодом - их оценка на [[Editory ERD]].

*[[Adresář|Address book]]
*[[Síť|Network]]

===ORM===

Одна из структур обеспечения Java API (например, Hibernate)

===Просмотры===

Выбор между JPS, JSF, RichFaces, ...

Specifications

2013-12-10T12:05:39Z

Sivosha:

[[cs:Specifikace]]
[[ru: Tехнические условия]]

== FreenetIS 1.0 ==

[http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/branches/qcodo/wwwroot/doc/FreeNetIS-specifikace_v_0-6.pdfThe initial specification], which was used to enter two dissertations and relied on by other developers. This specification but is currently valid. There have been many changes, for example payments were eventually resolved and implemented quite differently.

Thesis, resulting in the implementation of the basic members and payments.
* [http://zamestnanci.fai.utb.cz/~dulik/diplomky/2007-2008/Danek-MVC-Freenetis.pdf DP Petra Daňka]
Thesis, resulting in the implementation of the basic equipment.
* [http://zamestnanci.fai.utb.cz/~dulik/diplomky/2007-2008/Rozehnal-MVC-freenetis.pdf DP Marka Rozehnala]

The documentation for further expansion and modification of the system were created by other programmers, can only be found on this wiki or directly in the source code.

Introductory presentation on the implementation of the economy is:
*[[Media:Hospodareni.odp|formát ODP]]
*[[Media:Hospodareni.pdf|formát PDF]]

Motto FreenetIS 2 is a "system without compromise" - that is, we want to avoid from the beginning of the compromise decision we made in FreenetIS 1 and today we pay for it dearly need to make more and more compromises.

The whole FreenetIS should be created in Java EE.

===Database Schema===

Note: To draw ER diagrams, there are several open source projects - their assessment on the [[Editory ERD]].

*[[Adresář|Address book]]
*[[Síť|Network]]

===ORM===

One of the frameworks providing Java Persistence API (such as Hibernate)

===Views===

Choose between JPS, JSF, RichFaces, ...

Specifications

2013-12-10T12:04:38Z

Sivosha:

[[cs:Specifikace]]
[[ru: Tехнические условия]]

== FreenetIS 1.0 ==

[http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/branches/qcodo/wwwroot/doc/FreeNetIS-specifikace_v_0-6.pdfПо умолчанию] спецификация, которая была использована для двух диссертаций и основывалась на других разработчиках. Данная спецификация, но в настоящее время действующая. Там было много изменений, например платежи в конечном итоге были решены и реализованы совершенно по-разному.

Диссертации, в результате реализации основных членов и платежей.
* [http://zamestnanci.fai.utb.cz/~dulik/diplomky/2007-2008/Danek-MVC-Freenetis.pdf DP Petra Daňka]
Диссертации, в результате реализации основного оборудования.
* [http://zamestnanci.fai.utb.cz/~dulik/diplomky/2007-2008/Rozehnal-MVC-freenetis.pdf DP Marka Rozehnala]

Документация для дальнейшего расширения и модификации системы была создана другими программистами, может быть найдена только на этой вики или непосредственно в исходном коде.

Вводная презентация по реализации экономики:
*[[Media:Hospodareni.odp|formát ODP]]
*[[Media:Hospodareni.pdf|formát PDF]]

Девиз FreenetIS 2 "система без компромиссов" - то есть, мы хотим избежать компромиссных решений которые мы сделали в FreenetIS 1 и сегодня мы дорого расплачиваемся за это все большим числом компромиссов.

Весь FreenetIS должны быть созданы в Java EE.

===Схема базы данных===

Примечание: Чтобы нарисовать ER диаграммы, есть несколько проектов с открытым кодом - их оценка на [[Editory ERD]].

*[[Adresář|Address book]]
*[[Síť|Network]]

===ORM===

Одна из структур обеспечения Java API (например, Hibernate)

===Просмотры===

Выбор между JPS, JSF, RichFaces, ...