Xataface Wiki | Wiki

modules

Field

Value

Page name

modules

Page id

Page title

Xataface Modules

Content

Table of Contents

Xataface provides a number of hooks that allow developers to create modules to extend its functionality. This page lists a handful of the currently available modules.

Shopping Cart - Converts your application into a shopp

Keywords

modules, captcha

Language

XataJax

Field

Value

Page name

XataJax

Page id

113

Page title

Introduction to XataJax

Content

Table of Contents

Xataface 1.3 comes with a new module XataJax which comes installed standard. XataJax serves as a foundation for Javascript/AJAX powered Xataface applications and will hopefully usher in a new fresh generation of Xataface powered applic

Keywords

XataJax, Ajax, Web 2.0

Language

loginFailed

Field

Value

Page name

loginFailed

Page id

184

Page title

loginFailed() Application Delegate Trigger

Content

Table of Contents

Example

The loginFailed() method of the Application Delegate class is executed after a failed login attempt.

Available since 2.0.1

Example

<code> function loginFailed($username, $userIp, $time){ error_log("Failed login for user

Keywords

Language

field__pushValue

Field

Value

Page name

field__pushValue

Page id

105

Content

Table of Contents

The field__pushValue() delegate class method can be used to transform a field value as entered in the edit form into a format that can be stored in the database.. Sometimes it is the case that we want users to be able to work with data differe

Keywords

pullValue, pushValue

Language

field__pullValue

Field

Value

Page name

field__pullValue

Page id

104

Page title

field__pullValue delegate class method

Content

Table of Contents

The field__pullValue() delegate class method can be used to transform database from the database for use in an edit/new record form. Sometimes it is the case that we want users to be able to work with data differently than it is stored in the

Keywords

pushValue, pullValue

Language

LDAP_or_Active_Directory

Field

Value

Page name

LDAP_or_Active_Directory

Page id

Page title

How to authenticate users with LDAP or Active Directory

Content

Table of Contents

In the conf.ini

It is often easier to use the existing LDAP or Active Directory to authenticate users in Xataface than to create a new password for every user in the table users.

In the conf.ini

In the conf.ini file, in the [auth] part, you need to

Keywords

LDAP,Active Directory,Authentication

Language

Module_Developers_Guide

Field

Value

Page name

Module_Developers_Guide

Page id

112

Page title

Module Developers Guide

Content

Table of Contents

Why Write a Xataface Module?

Xataface modules are components that can be used to extend Xataface's functionality in a generic way so that it can be used on multiple applications. If you find yourself trying to add the same functionality

Keywords

modules

Language

Contribute_to_Xataface_Translation_Project

Field

Value

Page name

Contribute_to_Xataface_Translation_Project

Page id

110

Page title

How to Contribute Translations

Content

Table of Contents

Synopsis

Xataface stores its translations in INI files in its lang directory, one for each language. You can develop your own translation by first copying the en.ini file to xx.ini (where xx is the ISO language code for the language you

Keywords

Translations, Google Spreadsheets, en.ini, fr.ini

Language

Relationship_Permissions

Field

Value

Page name

Relationship_Permissions

Page id

111

Page title

Relationship Permissions

Content

Table of Contents

Synopsis

As relationships are a core feature of Xataface, it is helpful to understand how to handle permissions on related records. Even if you apply permissions to every table individually, you need to take into account the relationshi

Keywords

relationships, permissions, rel_relationshipname__permissions, getPermissions, permissions.ini

Language

registration_form

Field

Value

Page name

registration_form

Page id

Page title

Setting up User Registration

Content

Table of Contents

Synopsis

Xataface optionally enables you to allow users to register for an account in your application. If your users table includes a column for email, it will also perform email validation before the account is activated. Befor

Keywords

registration form, _auth, authentication

Language

reCAPTCHA_module

Field

Value

Page name

reCAPTCHA_module

Page id

Page title

The reCAPTCHA module

Content

Table of Contents

Synopsis

The Xataface reCAPTCHA module CAPTCHA support to any Xataface form that is rendered to the public (i.e. when users are not logged in). This is particularly useful for the registration form as a means of spam prevention.

Keywords

captcha, registration, validation

Language

Application_Delegate_Class

Field

Value

Page name

Application_Delegate_Class

Page id

Page title

Application Delegate Class

Content

Table of Contents

Synopsis

The application delegate class is similar to the table_delegate_class except that it is applicable to the application as a whole, not just one table. It allows the developer to implement hooks that

Keywords

application delegate class

Language

relationship

Field

Value

Page name

relationship

Page id

Page title

The relationship fields.ini directive

Content

Return to fields.ini file directives

Table of Contents

Synopsis

Certain types of widgets (e.g. grid (v1.0) and checkbox (v1.2)) support the relationship directive which allows them to effectively add/remove records from a specifie

Keywords

grid widget, relationship, checkbox

Language

secure

Field	Value
Page name	secure
Page id	88
Page title	secure fields.ini directive
Content	fields.ini file directive used only with container fields?. If this flag is set, then the field contents will be treated in a secure manner and will obey the application permissions. If this directive is not set, then uploaded files in [[containe
Keywords	secure,fields.ini file
Language	en

_auth

Field

Value

Page name

_auth

Page id

Page title

_auth section of the conf.ini file

Content

Return to conf.ini file

Table of Contents

Synopsis

The _auth section of the conf.ini file includes configuration directives to enable authentication in a Xataface application. For more information about authentication and regis

Keywords

_auth,authentication,conf.ini file,allow_register

Language

documentation_guide

Field	Value
Page name	documentation_guide
Page id	70
Page title	Documentation Guide
Content	Xataface uses a wiki to manage its online documentation which can be edited by anyone. All you have to do is login with your forum username and password ([http://xataface.com/forum/profile.php?mode=regis
Keywords	documentation wiki
Language	en

Authenticating_Against_the_Joomla!_Users_Table

Field	Value
Page name	Authenticating_Against_the_Joomla!_Users_Table
Page id	93
Content	Xataface is able to use the joomla users table to authenticate against so that, you can allow your users to log into your Xataface application using the same credentials as they use to access your joomla website. Achieving this level of integration requir
Keywords	joomla authentication md5
Language	en

no_access_text

Field	Value
Page name	no_access_text
Page id	59
Page title	no_access_text
Content	Whenever the NO_ACCESS permission is given for a field, normally the text NO ACCESS appears. But we might want to display another text. Here is an example of the text subscribe is used instead of NO ACCESS whenever the NO_ACCESS permissions is given.
Language	en

table

Field	Value
Page name	table
Page id	66
Page title	table
Content	When using widget:type table, it will store the data as XML. So the field type must be TEXT (or varchar... but text is better). You can decide which columns you want in the table by creating sub-fields in your fields.ini file as follows: Suppose you
Language	en

GettingStarted:Introduction

Field	Value
Page name	GettingStarted:Introduction
Page id	71
Page title	Introduction
Content	Web Lite is a simple framework for building data-driven web applications in PHP and MySQL. This section introduces some of the concepts and applications of Dataface. To fully understand what Xataface is, we must first define a few key terms: '''Fram
Keywords	introduction requirements getting started
Language	en

fieldpermissions

__field__permissions

Field	Value
Page name	__field__permissions
Page id	50
Page title	__field__permissions
Content	This method can be used to set the default permissions for all fields in a designated table, when specified in that table's delegate class. It comes in handy in situations when you want to deny access to all fields except for those designated, rather then
Language	en

Customizing_Theme_Based_on_IP_Address

Field	Value
Page name	Customizing_Theme_Based_on_IP_Address
Page id	103
Page title	Customizing Theme Based on IP Address
Content	This article deals with the following topics: Using field__pullValue/field__pushValue methods to customize how a field is edited and stored in the database. Using beforeHandleRequest to modify the application settings based on the user
Keywords	ip address, pullValue, pushValue, beforeHandleRequest
Language	en

Key

Field	Value
Page name	Key
Page id	83
Page title	fields.ini Directive: Key
Content	The Key directive is used only when the table is a view and you need to explicitly define which columns are part of the primary key. For example, if we created a view on the books table to only show books in a given year as follows: <code> create
Keywords	Key, Views, MySQL Views, Create View, PRI, Primary Keys
Language	en

XataJax_Compiler

Field

Value

Page name

XataJax_Compiler

Page id

114

Page title

Introduction to the XataJax Compiler

Content

Return to XataJax

DISCLAIMER: This page introduces features that require Xataface 1.3 or higher. At present (Jan. 2011) only Xataface 1.2.6 has been released to the public.

Table of Contents

Synopsis

The XataJax compiler is a Javascript

Keywords

XataJax, compiler, javascript, css, compiler

Language

lookup

Field

Value

Page name

lookup

Page id

Page title

The Lookup Widget

Content

Return to widget:type page to see list of all widget types. Back to fields.ini file to see other fields.ini directives.

Table of Contents

Synopsis

The lookup widget allows users to look a record from another table to insert into the field.

Keywords

lookup widget, widget:filters, widget:-filters:limit, widget:table

Language

list:type

Field

Value

Page name

list:type

Page id

128

Page title

list:type relationships.ini file directive

Content

Return to relationships.ini file

Table of Contents

The list:type directive allows you to override the default list that is used to display related records. As of Xataface 1.3 there is only one possible value that will have any effect on this directive: "

Language

meta:class

Field

Value

Page name

meta:class

Page id

127

Page title

meta:class relationships.ini file directive

Content

Return to relationships.ini file

Table of Contents

The meta:class directive allows you to ascribe special meaning to a relationship which Xataface can use in various parts of your application to provide enhanced capabilities.

For example you can sp

Language

global

__global__

Field

Value

Page name

__global__

Page id

106

Page title

__global__ section for the fields.ini file

Content

Return to fields.ini file

Table of Contents

Synopsis

The fields.ini file supports a __global__ section that applies to all fields in the current table. This is particularly useful for setting up default functionality that you wish to see on all

Keywords

__global__, fields.ini, visibility:list

Language

validators

Field

Value

Page name

validators

Page id

Page title

validators:NAME fields.ini directive

Content

Return to fields.ini file

Table of Contents

Synopsis

In the fields.ini file you can specify validation rules to be applied to any field by adding the validators:NAME directive in that field's section of the fields.ini file.

===Available Va

Keywords

validation, form validation, validators,validator:name

Language

validators:VALIDATOR_NAME:message

Field

Value

Page name

validators:VALIDATOR_NAME:message

Page id

Page title

validators:VALIDATOR_NAME:message directive for the fields.ini file

Content

Return to fields.ini file

Table of Contents

Synopsis

If you want to customize the error message associated with a particular validation rule? you can use the validators:VALIDATOR_NAME:message directive in the fields.ini file.

===F

Keywords

validation messages,error messages,form validation rules

Language