<?php_e('This is a brief documentation about this plugin. For more details, see also the <a href="http://dogwood.skr.jp/wordpress/sqlite-integration">Plugin Page</a>.',$domain);?>
</p>
<p>
<?php_e('Please don\'t forget: WordPress DOES NOT OFFICIALLY SUPPORT any database other than MySQL. So if you ask about this plugin in the Forum, it\'s not unlikely that you won\'t get no answers at all.',$domain);?>
<?php_e('This plugin is a successor to <a href="http://wordpress.org/extend/plugins/pdo-for-wordpress/">PDO for WordPress</a>, which enabled WordPress to use SQLite for its database. But PDO for WordPress doesn\'t seem to be maintained any more only to be outdated. SQLite Integration makes use of the basic ideas and framework of PDO for WordPress, adds some new features and updates it to be able to work with the newest version of WordPress(3.5.2 and 3.6 beta).',$domain);?>
<?php_e('<a href="http://www.sqlite.org/">SQLite Web Page</a> says — SQLite is a "software library that implements selfcontained, serverless, zero-configuration, transactional SQL database engine". It is "a good choice for small to medium size websites". It\'s small and portable, and you don\'t need any database server system.',$domain);?>
</p>
<p>
<?php_e('Unfortunately enough, WordPress only supports MySQL. Consequently it doesn\'t provide any APIs for SQLite. So if you want to create a website using WordPress without a database server, you\'ve got to write a kind of wrapper program yourself to use SQLite. This is the way SQLite Integration goes.',$domain);?>
</p>
<p>
<?php_e('SQLite Integration does the work as follows:',$domain);?>
</p>
<ol>
<li><?php_e('Intercepts SQL statement for MySQL from WordPress',$domain);?></li>
<li><?php_e('Rewrites it as SQLite can execute',$domain);?></li>
<li><?php_e('Gives it to SQLite',$domain);?></li>
<li><?php_e('Gets the results from SQLite',$domain);?></li>
<li><?php_e('Format the results as MySQL returns, if necessary',$domain);?></li>
<li><?php_e('Gives back the results to WordPress',$domain);?></li>
</ol>
<p>
<?php_e('WordPress doesn\'t know what has happened in the background and will be happy with it.',$domain);?>
</p>
<h3><?php_e('Limitations',$domain);?></h3>
<p>
<?php_e('SQLite Integration uses SQLite, so the limitations of SQLite is, as it is, those of SQLite Integration. MySQL is far from a simple SQL engine and has many extended features and functionalities. WordPress uses some of them. Among those are some SQLite doesn\'t implement. For those features that WordPress uses, I made them work with SQLite Integration. But for others that some plugins are using, SQLite Integration can\'t manipulate. So...',$domain);?>
</p>
<ol>
<li><strong><?php_e('There are some plugins that you can\'t use in any way.<br />',$domain);?></strong>
<?php_e('Some plugins can\'t be activated or work properly. See the "Plugin Compatibility/Incompatibility" section.',$domain);?></li>
<li><strong><?php_e('There are some plugins that you can\'t use without rewriting some codes in them.<br />',$domain);?></strong>
<?phpechosprintf(__('Some plugins do work fine if you rewrite MySQL functions. I made some patch files and <a href="%s?page=patch">Patch Utility</a>. See also the <a href="http://dogwood.skr.jp/wordpress/sqlite-integration">Plugin Page</a> for more details.',$domain),$utils->show_parent());?></li>
</ol>
<p>
<?php_e('And there may be other problems I overlooked. If you find malfunctionality, please let me know at the <a href="http://wordpress.org/support/plugin/sqlite-integration">Support Forum</a>.',$domain);?>
</p>
<h3><?php_e('User Defined Functions',$domain);?></h3>
<p>
<?php_e('SQLite Integration replaces some functions of MySQL with the user defined functions built in PHP PDO library. But some of the functions are meaningless in SQLite database: e.g. get_lock() or release_lock(). When SQLite Integration meets those functions, it does nothing but prevent the error.',$domain);?>
</p>
<p>
<?php_e('If you want SQLite Integration to execute more functions, you can add the definition in the file sqlite-integration/functions.php (functions-5-2.php is for PHP 5.2 or lesser).',$domain);?>
</p>
<h3><?php_e('Database Administration and Maintenance',$domain);?></h3>
<p>
<?php_e('SQLite Integration doesn\'t contain database maintenace functionality, because there are some other free or proprietary softwares that give you such functionalities. For example, these are among free softwares:',$domain);?>
<?php_e('WordPress without its plugins is a king without people. Of course, you need plugins, I know.',$domain);?>
</p>
<p>
<?phpechosprintf(__('Most of the plugins will work fine with this plugin. But there are some that you need to rewrite some codes in them, and there are others that you can\'t use with this plugin. This is the list of the problematic plugins (far from complete). You can see informations about your installed plugins in the <a href="%s?page=sys-info">System Info</a> page. To see more details, please visit the <a href="http://dogwood.skr.jp/wordpress/sqlite-integration">Plugin Page</a>.',$domain),$utils->show_parent());?>
<?php_e('Some plugins that give you cache functinality might cause problems. It is because they try to create the db.php file in wp-content directory, which file SQLite Integration is using.',$domain);?>
</p>
<p>
<?php_e('If those plugins overwrite the db.php file, SQLite Integration doesn\'t work. <span class="em">My recommendation is not to use caching plugins</span>. Even so, if you want a caching plugin, you could try <a href="http://wordpress.org/extend/plugins/wp-super-cache/">WP Super Cache</a>, which doesn\'t use db.php file. But no warranty, try at your own risk.',$domain);?>
</p>
<p>
<?php_e('I have not tested none of those caching plugins.',$domain);?>
</p>
<h3><?php_e('MySQL specific functions',$domain);?></h3>
<p>
<?php_e('Some plugins don\'t use WordPress database functions such as dbDelta(), and use PHP native MySQL functions when they create and manage tables in the database. But PHP doesn\'t permit redefining of the native functions (at least, under ordinary server setting). So SQLite Integration can\'t intercept and rewrite those functions.',$domain);?>
</p>
<p>
<?php_e('For example, you can see these codes in Google XML Sitemaps.',$domain);?>
<?php_e('Such functions as mysql_get_server_info() or mysql_query() are from the MySQL driver of PHP. Not only some plugins but WordPress uses them, but SQLite Integration has no way to rewrite or redefine them. If the plugin you want to use has those functions in it, it won\'t work or give the error messages.',$domain);?>
</p>
<p>
<?php_e('So, you have to rewrite them for SQLite Integration can execute. The two example above can be rewritten like this:',$domain);?>
<?php_e('As for those functions in WordPress, I overrode the WordPress functions themselves that contains such MySQL functions as mysql_query() or mysql_real_escape_string().',$domain);?>
</p>
<h3><?php_e('FULLTEXT index');?></h3>
<p>
<?php_e('Some plugins use FULLTEXT index of MySQL. Of course SQLite does have the functionality named "full-text search". But it is not correlated with that of MySQL. In fact it is not an "index" and requires another new table for that. And it has a different syntax. So you can\'t use the plugins which uses FULLTEXT index',$domain);?>
</p>
<p>
<?php_e('If your language is not written by separating words with spaces, e.g. Japanese, Chinese or Thai, neither FULLTEXT index nor full-text search work effectively. Even if your language is space-separating-words one, you don\'t have to be disappointed. Whatever languages you use, you can use <a href="http://wordpress.org/extend/plugins/wordpress-23-related-posts-plugin/">WordPress Related Posts</a> or <a href="http://wordpress.org/extend/plugins/related-posts/">Related Posts</a> or others. They are working fine with SQLite Integration!',$domain);?>
