> For the complete documentation index, see [llms.txt](https://xoops.gitbook.io/wgtransifex-module-tutorial/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xoops.gitbook.io/wgtransifex-module-tutorial/2administration/toolstxadmins.md).

# Tools for TX Admins

For Transifex admins are different additional tools available.

Basically it would be possible to create also the project itself, but as we need to make different setting for Translation manager it is necessary that you create the project first, and then you can upload all related files.

Transifex admins have the possibility to define the resources for a project locally and upload all the files in bulk. Therefore it isn't necessary to do this manually file by file.

## Quickstart

* Create new project on Transifex
* Download project on tab 'project' and set status to ![](/files/-MDpKrH_PdoxsWMMND8P)'local data'
* for module translation 
  * click on ![](/files/-MDpKrlyG045ESM96Hae) 'Read resources of existing module'
  * data check will be done automatically
* for XOOPS Core translation
  * ![](/files/-MDpKrlwKsp2ul2huEdz) copy resource data from previous XOOPS Core translation
  * start ![](/files/-MDpKrm0lFELWCT3xspN) upload data check on tab resources
* if necessary adapt data
* ![](/files/-MDsghwRBS30U6kC3eXg) upload resources to Transifex

Done.

## Detailed Instructions

### Preferences

In order to activate/show the tools set in preferences 'Show Tx Admin Tools' to 'Yes'. Activate only, if you have admin permission in Transifex, otherwise the procedures running into an error.

### Tools

#### Projects

On tab 'Projects' you find now the possibility

* ![](/files/-MDpKrlwKsp2ul2huEdz) to copy resource data from one project to another one
* ![](/files/-MDpKrlxQFq8ixBQwH7k) to copy resource data from one project to a new one
* ![](/files/-MDpKrlyG045ESM96Hae) to read all files of english language folder from a moduleas resource data 

![](/files/-MDpKrlzgZ3bYWaxUQ8M)

If you create a local project for upload you have to define whether this is a project for module files or the XOOPS Core. This is necessary to find the proper starting directory for uploading the file.

The new local project must have status ![](/files/-MDpKrH_PdoxsWMMND8P) 'Local data'.

All files must exist in your current XOOPS environment.

#### Resources

On tab 'Resources' you find now the possibility to test the resources and to upload the resources.

![](/files/-MDpKrm-h1cDwjOAsbCu)

![](/files/-MDpKrm0lFELWCT3xspN) During testing the resources following will be done:

* Check whether the files are available or not
* Check whether the resource is already available on transifex

If project type is 'Upload from module' you have to select the module

![](/files/-MDpKrm16K2mvPXhsho4)

If project type is 'XOOPS Core' then starting directory is the current XOOPS root directory.

As a result you get a list of check result

![](/files/-MDpKrm2w7AU6uGM6Hcx)

**Attention: Do not start the upload before all checks are successfully.**

![](/files/-MDpKrm3ckHLHvcb0ejy)

If a problem or an error occure during upload procedure you get a error message

![](/files/-MDpKrm4oo4WYRnaP81c)

This error message contains the file and the reason, e.g. like in example: file common.php doesn't hat PHP DEFINE structure. Please check the file and resource data and restart upload.

If upload is successful you get result list:

![](/files/-MDpKrm5AvWxM5XOsZg1)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://xoops.gitbook.io/wgtransifex-module-tutorial/2administration/toolstxadmins.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.