Differences from version 33 to 41



@@ -1,6 +1,7 @@

 {maketoc}
 The Bitweaver Framework, consisting of Liberty and Kernel, offers you a lot of functionality. Here we'll try to show how you can make use of that.
 
+!Your Own Package
 !Business Objects a la Liberty
 !!Which base class?
 If you want to create your own [http://en.wikipedia.org/wiki/Business_object_(computer_science)|Business Object], you will probably use LibertyAttachable as base class, as it offers most functionality. Use LibertyContent or LibertyBase when you know what you are doing.

@@ -103,7 +104,9 @@

  WHERE lc.`content_type_guid` = ? $whereSql
  ORDER BY ".$this->mDb->convert_sortmode( $sort_mode );
  $query_cant = "select count(*)
- FROM `".BIT_DB_PREFIX."eventcal_events` ts INNER JOIN `".BIT_DB_PREFIX."liberty_content` lc ON( lc.`content_id` = ts.`content_id` ) $joinSql
+ FROM `".BIT_DB_PREFIX."eventcal_events` ts
+ INNER JOIN `".BIT_DB_PREFIX."liberty_content` lc ON( lc.`content_id` = ts.`content_id` )
+ $joinSql
  WHERE lc.`content_type_guid` = ? $whereSql";
 
  $result = $this->mDb->query( $query, $bindVars, $max_records, $offset );

@@ -126,7 +129,7 @@

 !Make something visible: The UI
 Probably you cannot wait to display somethind on the screen. Up to now we had concentrated on your data objects - the model. Bitweaver works with the MVC pattern. Find out more about this pattern in ((Model View Controller - MVC)), but now we make use of the model, create a simple controller and focus on the view.
 
-{attachment id=268 float=right} Have a look at this picture. It should give you a rough idea of what part of a bitweaver page you will be working on.
+{attachment id=268 float=right padding=20px} Have a look at this picture. It should give you a rough idea of what part of a bitweaver page you will be working on.
 
 In most cases you write ordinary module code that goes into the main area in the middle. Then you can place any HTML/JavaScript/whatever code in your templates but surround it with the tag <div class="bitmain">, which will look like this:
 {code}

@@ -152,6 +155,7 @@

 *The Template (View)
 !!Feedback and Confirmation
 Up to now, the answer is to look at the ((SamplePackage)) and guess.
+errors, warnings, message text and confirmation dialogs
 *gBitSystem->setBrowserTitle()
 *gBitSystem->confirmDialog()
 !Authorisation Required

@@ -234,7 +238,15 @@

 
 !!Data Format
 !!!National language characters
-What encoding should be used for the PHP file? How shall national language characters (at worst the complete unicode character set) be escaped?
+^Short answer: Make sure all your PHP and TPL files are encoded in UTF-8.^
+
+Apache, PHP and Bitweaver operate on byte streams. Character sequences are just arrays of bytes. So you need not care what character encoding your national special characters are in - as long as the data is supplied by browsers.
+
+Per default Bitweaver tells the web browser that UTF-8 is used. Therefore any data presented to the browser is assumed to be UTF-8 (even if it is not which results in garbage) and the browser will send user input encoded in UTF-8. That solves the problem almost completely.
+
+There are two items which you will have to look at: Your PHP source and template files. Again, PHP does not assume any encoding on the files, they are just loaded as byte arrays. The PHP code in these files should not contain anything beyond ASCII, but any characters within string literals can. And this data goes untouched through the whole system until it has to be displayed on the screen. As mentioned earlier, the browser will assume all data to be in UTF-8. So you can see garbabe being displayed unless you change the encoding of those characters.
+
+__Note:__ I've seen troubles with trimming down text with special chars. The common example is when article gets automaticly cut after the set number of letters, and the rest is placed to the "read more" part. It says letters, but it actually uses bytes to count. It takes 2 bites to encode most non-Latin1 chars, so after trimming sometimes the last letter is presented with only one bite of 2 necessary, and shows in browser as garbage. So until this is fixed somehow, avoid trimming texts by your php files and templates if you use special chars.
 
 !!!Timestamps
 Bitweaver is said to use UTC times within the database. What times are used on timestamps in the installer?
Page History
Date/CommentUserIPVersion
27 Jan 2007 (17:03 UTC)
dspt213.184.224.341
Current • Source
hiran85.233.40.19239
View • Compare • Difference • Source
hiran85.233.40.19238
View • Compare • Difference • Source
hiran85.233.40.19234
View • Compare • Difference • Source
hiran85.233.40.19233
View • Compare • Difference • Source
hiran85.233.40.19228
View • Compare • Difference • Source
hiran85.233.40.19227
View • Compare • Difference • Source
hiran85.233.40.19226
View • Compare • Difference • Source
hiran85.233.40.19225
View • Compare • Difference • Source
hiran85.233.40.19224
View • Compare • Difference • Source
hiran85.233.40.19223
View • Compare • Difference • Source
hiran85.233.40.19222
View • Compare • Difference • Source
hiran85.233.40.19221
View • Compare • Difference • Source
hiran85.233.40.19220
View • Compare • Difference • Source
hiran85.233.40.19219
View • Compare • Difference • Source
hiran85.233.40.19218
View • Compare • Difference • Source
hiran85.233.40.19217
View • Compare • Difference • Source
hiran85.233.40.19216
View • Compare • Difference • Source
hiran85.233.40.19214
View • Compare • Difference • Source
hiran85.233.40.19212
View • Compare • Difference • Source
hiran85.233.40.19211
View • Compare • Difference • Source
hiran85.233.40.19210
View • Compare • Difference • Source
hiran85.233.40.1928
View • Compare • Difference • Source
hiran85.233.40.1927
View • Compare • Difference • Source
hiran85.233.40.1925
View • Compare • Difference • Source
hiran85.233.40.1924
View • Compare • Difference • Source