PHP Classes
elePHPant
Icontem

msgcat: Message Catalog System

Recommend this page to a friend!
Stumble It! Stumble It! Bookmark in del.icio.us Bookmark in del.icio.us
  Info   View files View files (6)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Last Updated Ratings Unique User Downloads Download Rankings  
2002-07-26 (13 years ago) RSS 2.0 feedNot yet rated by the usersTotal: 1,872 All time: 1,985 This week: 1,201Up
Version License Categories  
msgcat 1.0.0GNU General Publi...Localization
Description Author  

Basic message Catalog utility for php, provides a basic way to generate multiple languages scripts

Picture of Carlos Falo Hervás
Name: Carlos Falo Hervás <contact>
Classes: 10 packages by
Country: Spain Spain
Age: 40
All time rank: 301 in Spain Spain
Week rank: 894 Down21 in Spain Spain Down
Innovation award
Innovation award
Nominee: 1x

Details provided by the author  
===== BASIC DOCUMENTATION FOR MSGCAT Multi Language class v 1.0 =====

0.- INTRODUCTION

  This class is designed as a message catalog (just like in TCL or other
  scripting tools).  Builds an array of translations for string identifiers
  and can be quite useful to deploy multiple language versions of the same
  scripts.  NOTE IT STORES FULL MSG CATALOG ON MEMORY, DO NOT USE ON HEAVY
  TRANSLATION ENVIRONMENT

1.- INTERFACE

  The public interface for the class is formed by:

  msgcat($localstr,$loaddir="./",$debug=0)
	
    CONSTRUCTOR: Initializes catalog

	$localstr -> locale string identifier, used to determine translation
		     file and msg validation
	$loaddir  -> full path from current path to find *.msg files for the class
	$debug    -> Debug level: 0-none; 1- <!-- --> echo; 2 - file 'debug' in $loaddir 

  mc($srcstr)

    TRANSLATOR: Returns (string) translation for $srcstr for current locale

	$srcstr   -> identifier to translate


  destroy()  

    DESTRUCTOR; Close file operations and such


2.- MSG CATALOG FILES

  Each locale must have a file named [locale].msg to be used

	i.e. ENGLISH msg cataloc should be en.msg

  File contents will be as follows:

	[locale]#:#[identifier]#:#[translation]\n

	i.e. en#:#WM#:#Greetings, wellcome to my site
	     en#:#CM#:#Come back soon!

  Comments can be added to the file on a line starting with '//'

	i.e. // General Messages
	     en#:#MSG1#:#Test message 1
	     //Section names
	     en#:#SECT1#:#File Archives
	     en#:#SECT2#:#New entries						

3.- CODING EXAMPLE

  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
  <?php require("msgcat_class.php") ; ?>
  <html>
    <head>
      <title>MSGCAT test</title>
    </head>
    <body>
    <?php
    $msg = new msgcat("en") ;
    echo $msg->mc("WM") ;
    $msg->destroy() ;
    ?>
    </body>
  </html>

  This will output (based on the en.msg file from section 2 ex. 1)

     Greetings, wellcome to my site

4.- Future releases and WIP

  This class will not have many revisions as it is fully functional for
  it's intended use.  For furtehr developement any suggestions are wellcome

3.- Contact information

  Carlos Falo Hervás
  carles@bisinteractive.net
  http://www.bisinteractive.net

  C/Manila 54-56 Esc. A Ent. 4ª
  08034 Barcelona Spain

  Phone: +34 9 3 2063652
  Fax:	 +34 9 3 2063689
  Files folder image Files  
File Role Description
Accessible without login Plain text file debug Output Demo debug file
Accessible without login Plain text file en.msg Example Demo msg file
Accessible without login Plain text file LICENSE Doc. GNU GPL License
Plain text file msgcat_class.php Class msgcat class
Accessible without login Plain text file readme.txt Doc. Documentation
Accessible without login Plain text file test.php3 Example Demo script

 Version Control Unique User Downloads Download Rankings  
 0%Total:1,872All time:1,985
 This week:0This week:1,201Up