Download the PHP package vbridier/zf2-smarty-gettext without Composer

On this page you can find all versions of the php package vbridier/zf2-smarty-gettext. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package zf2-smarty-gettext

Gettext support for Smarty2/Smarty3 with ZF2

zf2-smarty-gettext provides gettext (i18n) support for Smarty with Zend Framework 2, the popular PHP templating engine, to implement an NLS (Native Language Support) API which can be used to internationalize and translate your PHP applications.

This README assumes that you already know what is gettext and how to use it with PHP.

If you don't, please visit the following websites before trying to use this package:

  1. http://www.php.net/gettext
  2. http://www.onlamp.com/pub/a/php/2002/06/13/php.html

This package has two parts:

  1. block.t.php - The Smarty plugin.
  2. tsmarty2c.php - A command line utility that rips gettext strings from smarty source files and converts them to .pot (PO-Template).

Installation

With Composer:

function.locale.php

Lets you set the locales path in master smarty template.

In order to use it put {locale path="PATH_TO_TRANSLATIONS_RELATIVE_TO_TEMPLATES_DIRECTORY" domain="YOUR_TRANSLATIONS_DOMAIN"} somewhere in the top of your master template.

block.t.php

The Smarty plugin

Usage

The content of the block function is the string that you want to translate. For example, for translating Hello World, use: {t}Hello World{/t}.

If you have dynamic parameters that should be set inside the string, pass them to the block function, and they will be replaced with %n, where n is 1 for the 1st parameter and so on.

For example, {t name="sagi"}my name is %1{/t} will replace %1 with sagi.

The parameter name is ignored, unless it is one of the reserved names (see below). Only the parameters order matters.

Example for using multiple parameters:

{t 1='one' 2='two' 3='three'}The 1st parameter is %1, the 2nd is %2 and the 3rd %3.{/t}

NOTE: I decided to use numeric arguments instead of sprintf(), mainly because its syntax is simpler for the translators (especially when wanting to change the parameter order).

You can also use this method in your PHP code, by using the smarty_gettext_strarg() function. It is only loaded after block.t.php is included, so you probably want to copy it elsewhere.

I usually name the global version of this function strarg(), and use it like this:

echo strarg(_('hi %1'), $name [,..]);

By default, all the translated strings will be automatically HTML escaped. You may control this by setting the escape parameter. Possible values:

Example:

{t escape=no url="http://www.php.net/" name="PHP website"}
<a href="%1">%2</a>
{/t}

Using variables

Sometimes you need translated block passed as variable. This can be achieved with capture block:

{capture assign="extra_title"}{t}Weekly report{/t}{/capture}
{include file="header.tpl.html" extra_title=$extra_title}

Plural support

The package also provides support for plural forms (see ngettext).

To provide a plural form:

  1. Set a parameter named plural with the plural version of the string.
  2. Set a parameter named count with the variable count.

Plural and count are special parameters, and therefore, are not available as numeric arguments. If you wish to use the count value inside the string, you will have to set it again, as a numeric argument.

Example:

{t count=$files|@count 1=$files|@count plural="%1 files"}One file{/t}

Modifier support

A Smarty modifier support is not provided by this package.

I believe variables should be translated in the application level and provided after translation to the template.

If you need it anyway, it is easy to create such modifier, by simply registering the PHP gettext command as one.

tsmarty2c.php - the command line utility

This utility will scan templates for {t}...{/t} placeholders for translation strings and output a .pot file (.po template).

Usage:

./tsmarty2c.php -o template.pot <filename or directory> <file2> <...>

If a parameter is a directory, the template files within will be parsed, recursively.

In output special PO tags are added that inform about location of extracted translation. Most of the PO edit tools can respect that information.

If you wish to scan also .php or .phtml files for native gettext calls, you may wish to combine result of tsmarty2c and xgettext calls:

By default tsmarty2c scans for .tpl files, if you wish to use other files, you can use xargs in unix:

See how it's done in Eventum project.

Authors


All versions of zf2-smarty-gettext with dependencies

PHP Build Version
Package Version
Requires ext-gettext Version *
ext-pcre Version *
php Version >=5.2.1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package vbridier/zf2-smarty-gettext contains the following files

Loading the files please wait ....