Core class used to implement the translation sets.
| since | 1.0.0 |
|---|---|
| package | GlotPress |
| inherited_from | \GP_Thing |
__construct($fields = array())
after_create() : boolean
This is a placeholder function which should be implemented in the child classes.
| since | 2.4.0 |
|---|---|
| inherited_from | \GP_Thing::after_create() |
booleanafter_create() : boolean
This is a placeholder function which should be implemented in the child classes.
booleanafter_delete() : boolean
This is a placeholder function which should be implemented in the child classes.
| since | 2.4.0 |
|---|---|
| inherited_from | \GP_Thing::after_delete() |
booleanafter_delete() : boolean
This is a placeholder function which should be implemented in the child classes.
booleanafter_save(\GP_Translation_Set $translation_set_before) : boolean
This is a placeholder function which should be implemented in the child classes.
| since | 2.4.0 |
|---|---|
| inherited_from | \GP_Thing::after_save() |
\GP_Translation_SetTranslation set before the update.
booleanafter_save(\GP_Thing $thing_before) : boolean
This is a placeholder function which should be implemented in the child classes.
\GP_ThingObject before the update.
booleanall($order = null)
all_count() : integer
integerNumber of all originals.apply_default_conditions($conditions_str)
by_locale($locale_slug)
by_project_id($project_id)
by_project_id_slug_and_locale($project_id, $slug, $locale_slug)
coerce($thing)
copy_translations_from($source_translation_set_id)
This function doesn't merge then, just copies unconditionally. If a translation already exists, it will be duplicated. When copying translations from another project, it will search to find the original first.
create($args) : mixed
array associative array with fields as keys and values as values
mixedthe object corresponding to the inserted row or false on errorcreate_and_select($args) : mixed
array see create()
mixedthe selected object or false on errorcurrent_count() : integer
integerNumber of current translations.delete() : boolean
| since | 2.0.0 |
|---|---|
| inherited_from | \GP_Thing::delete() |
booleandelete()
| since | 1.0.0 |
|---|
delete_all(array $where = null)
| since | 1.0.0 |
|---|
arrayAn array of conditions to use to for a SQL "where" clause, if null, not used and all matching rows will be deleted.
delete_many(array $where = null)
| since | 2.0.0 |
|---|
arrayAn array of conditions to use to for a SQL "where" clause, if not passed, no rows will be deleted.
existing_locales()
existing_slugs()
fields()
find(string|array $conditions, string|array $order = null) : mixed
| since | 1.0.0 |
|---|
stringarray
stringarrayOptional.
mixedfind_many(string|array $conditions, string|array $order = null) : mixed
| since | 1.0.0 |
|---|
stringarray
stringarrayOptional.
mixedfind_many_no_map(string|array $conditions, string|array $order = null) : mixed
| since | 1.0.0 |
|---|
stringarray
stringarrayOptional.
mixedfind_no_map(string|array $conditions, string|array $order = null) : mixed
| since | 1.0.0 |
|---|
stringarray
stringarrayOptional.
mixedfind_one(string|array $conditions, string|array $order = null) : mixed
| since | 1.0.0 |
|---|
stringarray
stringarrayOptional.
mixedforce_false_to_null($value)
found_rows()
fuzzy_count() : integer
integerNumber of fuzzy translations.get($thing_or_id)
get_db_field_formats($args)
get_static($name, $default = null)
has_static($name)
import(\Translations $translations, string $desired_status = 'current') : boolean
\Translationsthe translations to be imported to this translation-set.
string'current', 'waiting' or 'fuzzy'.
booleanor voidlast_modified()
like_escape_printf($s)
many() : mixed
For parameters description see $wpdb->prepare().
| since | 1.0.0 |
|---|
mixedAn object, containing the selected row or false on error.many_no_map() : mixed
| since | 1.0.0 |
|---|
mixedmap(mixed $results) : mixed
| since | 1.0.0 |
|---|
mixedThe results, mapped.
mixedmap_no_map(mixed $results) : mixed
| since | 1.0.0 |
|---|
mixedThe results, unmapped.
mixedname_with_locale(string $separator = '→') : string
If the slug of the locale is not 'default' then the name of the current translation sets gets added as a suffix.
| since | 1.0.0 |
|---|
stringSeparator, in case the slug is not 'default'. Default: '→'.
stringThe English name of a locale.normalize_fields(array $args) : array
| since | 1.0.0 |
|---|---|
| inherited_from | \GP_Thing::normalize_fields() |
arrayArguments for a GP_Translation_Set object.
arrayNormalized arguments for a GP_Translation_Set object.normalize_fields(array $args) : array
| todo | Include default type handling. For example dates 0000-00-00 should be set to null |
|---|---|
| since | 1.0.0 |
arrayArguments for a GP_Thing object.
arrayNormalized arguments for a GP_Thing object.now_in_mysql_format()
one() : mixed
For parameters description see BPDB::prepare()
mixedan object, containing the selected row or false on errorpercent_translated()
prepare($args)
prepare_fields_for_create($args)
prepare_fields_for_save($args)
query() : mixed
| since | 1.0.0 |
|---|
mixedreload()
restrict_fields(\GP_Validation_Rules $rules)
| since | 1.0.0 |
|---|---|
| inherited_from | \GP_Thing::restrict_fields() |
\GP_Validation_RulesThe validation rules instance.
restrict_fields(\GP_Validation_Rules $rules)
| since | 1.0.0 |
|---|
\GP_Validation_RulesThe validation rules instance.
save(mixed $args = null) : boolean | null
| since | 1.0.0 |
|---|
mixedValues to update.
booleannullNull and false on failure, true on success.select_all_from_conditions_and_order($conditions, $order = null)
set_fields($db_object)
set_memory_limit($new_limit)
set_static($name, $value)
sql_condition_from_php_value($php_value)
sql_from_conditions($conditions)
sql_from_order($order_by, $order_how = '')
sql_limit_for_paging($page, $per_page = null)
untranslated_count() : integer
integerNumber of untranslated originals.update($data, $where = null)
array associative array with fields as keys and updated values as values
update_status_breakdown()
validate()
value() : scalar
For parameters description see BPDB::prepare()
scalarthe result of the query or false on errorwaiting_count() : integer
integerNumber of waiting translations.warnings_count() : integer
integerNumber of translations with warnings._no_map(string $name, mixed $args) : mixed
| since | 1.0.0 |
|---|
stringMethod name.
mixedMethod-dependent arguments.
mixed$all_count : integer
$class
$current_count : integer
$default_conditions
$errors
array()$field_names
array('id', 'name', 'slug', 'project_id', 'locale')| inherited_from | \GP_Thing::field_names |
|---|
$field_names
array()$fuzzy_count : integer
$id : integer
| inherited_from | \GP_Thing::id |
|---|
$id
$int_fields
array('id', 'project_id')| inherited_from | \GP_Thing::int_fields |
|---|
$int_fields
array()$locale : string
$map_results
true$name : string
$non_db_field_names
array('current_count', 'untranslated_count', 'waiting_count', 'fuzzy_count', 'all_count', 'warnings_count', 'percent_translated', 'wp_locale', 'last_modified')| inherited_from | \GP_Thing::non_db_field_names |
|---|
$non_db_field_names
array()$non_updatable_attributes
array('id')| inherited_from | \GP_Thing::non_updatable_attributes |
|---|
$non_updatable_attributes
$per_page
30$project : \GP_Project
$project_id : integer
$slug : string
$static
array()$static_by_class
array()$table
null$table_basename
'gp_translation_sets'| inherited_from | \GP_Thing::table_basename |
|---|
$table_basename
$untranslated_count : integer
$validation_rules
null$validation_rules_by_class
array()$waiting_count : integer
$warnings_count : integer