> For the complete documentation index, see [llms.txt](https://w3pd-digital.gitbook.io/plugin-nomalizator/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://w3pd-digital.gitbook.io/plugin-nomalizator/overview/what-this-plugin-does.md).

# What this plugin does

Este plugin deve ser utilizado quando se deseja **Codificar e/ou Decodificar URI** completo.

Essa codificação é amplamente utilizada e, necessária, quando se transmite em uma url, frases que se utilizam de *espaço*, *símbolos* e *caracteres da língua*, que precisam da garantia de que, ao chegar no destino, possam ser decodificadas e interpretadas conforme foram enviadas, sem perdas ou trocas de qualquer caractere.  

Um exemplo disto pode ser visto em url´s utilizadas em links que encaminham o usuário para o WhatsApp já com um texto pré-formatado visando padronizar e facilitar o primeiro contato de um cliente.

Um exemplo de uso para este caso seria codificar a frase que se deseja passar como parâmetro (parâmetro text) para que, ao chegar no destino, ela mantenha todas a pontuação e acentuação esperada. \
\
A frase "`Olá, gostaria de saber como chegar até vocês!`" ao ser codificada ficaria "`Ol%C3%A1,%20gostaria%20de%20saber%20como%20chegar%20at%C3%A9%20voc%C3%AAs!`"

Dessa forma, ela poderá ser transmitida através de um link com a certeza de que, ao chegar no destino, será decodificada e aparecerá da maneira que se espera. \
\
Em nosso exemplo, a url completa para o envio seria como essa: [https://api.whatsapp.com/send?phone=5588888888888\&text=Ol%C3%A1%2C%20gostaria%20de%20saber%20como%20chegar%20at%C3%A9%20voc%C3%AAs!](https://api.whatsapp.com/send?phone=5585989338888\&text=Ol%C3%A1%2C%20gostaria%20de%20saber%20como%20chegar%20at%C3%A9%20voc%C3%AAs!)

### Como este plugin trabalha

O plugin trás a função **encodeURI( )** para codificar a url, exceto os caracteres `(, / ? : @ & = + $ #)` e trás também,a função **encodeURIComponent( )** que codifica inclusive os caracteres `(, / ? : @ & = + $ #)`.

Para decodificar utiliza as funções **decodeURI( )** para textos codificados com encodeURI( ) e a função **decodeURIComponent( )**, para textos que foram codificados com a função encodeURIComponente( ) (quando se tem os caracteres especiais). 


---

# 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:

```
GET https://w3pd-digital.gitbook.io/plugin-nomalizator/overview/what-this-plugin-does.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.