Differences

This shows you the differences between two versions of the page.

--- development [19-02-2012 18:58] – external edit 127.0.0.1
+++ development [28-06-2020 21:50] (current) – [Creating a New Release from Development Code] cwacha
@@ Line 18: / Line 18: @@
 To checkout the newest development version, enter the following command on the commandline
-  svn co https://iaddressbook.svn.sourceforge.net/svnroot/iaddressbook/trunk iaddressbook-dev
+  svn co https://svn.code.sf.net/p/iaddressbook/code/trunk iaddressbook-dev
+===== XML-RPC API =====
+[[docs:xmlrpc|The XML-RPC API has its own page here]]
 ===== Testing =====
@@ Line 40: / Line 44: @@
 ===== Translation =====
-Translation into other languages is very easy. Every language definition is stored in a **php**-file which resides in a separate folder for every language below the **//lang//** folder. Example: **//lang/en/lang.php//** contains the english language strings. The folder names for languages are in 2-letter ISO format (en = english, de = german, it = italian etc.).
+Translation into other languages is very easy. Every language definition is stored in a **php**-file which resides in a separate folder for every language below the **//lib/lang//** folder. Example: **//lib/lang/en/lang.php//** contains the english language strings. The folder names for languages are in 2-letter ISO format (en = english, de = german, it = italian etc.).
 <note important>
@@ Line 64: / Line 68: @@
 $lang['label_organization'] = 'Company';
 </code>
+===== Templates =====
+This section describes the HTML template that is currently used. In the current state the template system should be flexible enough to allow you to design a look and feel as you like (and not as the template system likes).
+The template files have the file ending ''.tpl''. The main file that keeps it all together is called **main.tpl**.
+  main.tpl
+     |
+     +- search.tpl
+     |
+     +- tpl_showcontactlist()
+     |   +- contactlist.tpl
+     |       +- tpl_contactlist()
+     |           +- contactlist_item.tpl
+     |
+     +- tpl_showperson()
+         +- person_empty.tpl
+         |
+         +- person.tpl
+         |   +- tpl_addresses()
+         |   |   +- address.tpl
+         |   |
+         |   +- tpl_phones()
+         |   |   +- phone.tpl
+         |   |
+         |   +- tpl_emails()
+         |   |   +- email.tpl
+         |   |
+         |   +- tpl_chathandles()
+         |   |   +- chathandle.tpl
+         |   |
+         |   +- tpl_urls()
+         |   |   +- url.tpl
+         |   |
+         |   +- tpl_relatednames()
+         |
+         +- person_edit.tpl
+             +- tpl_include()
+             |   +- person_edit_phones.tpl
+             |
+             +- tpl_include()
+             |   +- person_edit_emails.tpl
+             |
+             +- tpl_include()
+             |   +- person_edit_urls.tpl
+             |
+             +- tpl_include()
+             |   +- person_edit_relatednames.tpl
+             |
+             +- tpl_include()
+             |   +- person_edit_chathandles.tpl
+             |
+             +- tpl_include()
+                 +- person_edit_addresses.tpl
+  * //tpl_showcontactlist()// creates the list of contacts. It basically just inserts the file **contactlist.tpl**
+  * //tpl_contactlist()// iterates over all contacts and outputs one **contactlist_item.tpl** per contact.
+  * All other functions work the same way, you should get the hang of it. Remark that **person_edit.tpl** does not call any //tpl_functions// since i thouhgt it would be easier to just inline all the code. Other suggestions are welcome. I have never done a template system before, so it might still have some inconsitencies.
 ===== Analysis =====
@@ Line 77: / Line 145: @@
 This is a MUST-HAVE list. My personal addresses are normally stored inside Apples AddressBook which I find to perfectly fit all my needs. I thought that a web based equivalent, that behaves pretty much the same would be very cool.
-==== Existing Work ====
+==== Existing Work (as of 2007) ====
 This is a list of all PHP addressbook applications I found on the web including a short comment why they did not fit my needs.
@@ Line 99: / Line 167: @@
 ===== Creating a New Release from Development Code =====
-  * update version number
+  * update ''src/VERSION''
-  * remove /conf/config.php
+  * adjust ''src/lib/sql/*.sql'' schemas and db if necessary
-  * remove /conf/auth.php
+  * update ''src/README.txt'' and ''src/INSTALL.txt''
-  * disable translator.php
+  * run ''pkg/pkgmake.sh all''
-  * request updates from translators
+  * run ''pkg/pkgmake.sh deploy''
-  * update /README.txt
+  * final test in DEV
-  * adjust /INSTALL.txt if necessary
+  * git tag -a -m "releasing version 4.1.0" release-v4.1.0
-  * adjust /addressbook.sql if necessary
+  * git push origin --tags
-  * adjust /sqlite/* schemas and db if necessary
+  * run ''pkg/pkgmake.sh all''
+  * run ''pkg/pkgmake.sh deploy'' to DEV site (again)
+  * Draft new release in github (Release title: iaddressbook-4.1.0-191)
+  * Upload artifacts to github release
+  * adjust [[download]] and [[changelog]]
+  * run ''pkg/pkgmake.sh deploy'' to DEMO site