WPCS

O shortcode aceita value, ou meta_value com um post_id opcional; post_id sem meta_value lê a chave meta wpcs_price. price() multiplica pela taxa apenas quando a moeda atual difere da base, e depois passa o número para format_price_numeric() e para o filtro wpcs_price.

price_html() envolve o resultado num span com um ID único e data-amount com o valor base, que o modo de cache de páginas usa mais tarde para o voltar a apresentar.

Para preços fixos, o shortcode converte a lista num mapa e mostra o montante da moeda atual, ou 'none' se faltar. A lista de preço em todas as moedas usa o mesmo mapa em vez de converter.

JPY e TWD são sempre mostrados sem cêntimos; qualquer moeda pode ser acrescentada a essa lista com hide_cents. As definições incluem decimais por moeda e separadores decimal e de milhares por moeda. A escolha do separador é um índice em dois arrays paralelos, em que o índice 0 significa a definição global, de modo que os sites existentes mantêm a sua formatação.

O interest é um montante fixo guardado junto à taxa. get_currencies() soma-o à taxa em todo o lado, exceto na página de definições do plugin, de modo que o administrador edita a taxa limpa enquanto o front end converte com a ajustada. Um filtro wpcs_currency_data_manipulation corre depois disso para regras personalizadas.

A lista de informação de preço retira o separador de milhares da string já formatada, normaliza o separador decimal, converte de volta para a base com back_convert() (1/taxa) e depois para cada uma das outras moedas. O endpoint [wpcs_converter] usa rate[to] / rate[from], ambas relativas à base, e elimina os cêntimos nas moedas sem cêntimos.

Para um preço convertido, o shortcode memoriza a moeda do visitante, passa para a moeda pedida se estiver configurada, apresenta e volta atrás, de modo que o resto da página mantém a escolha do visitante.

O changelog regista a instabilidade: Yahoo removido na 1.1.1 (2017), Google removido na 1.1.2 (2018), ambos repostos na 1.1.3 (2018), fontes que deixaram de funcionar removidas de novo na 1.1.3 e na 1.1.4, agregadores personalizados através de um hook na 1.1.5 (2020). Cada fonte é uma classe com getApiUrl() e parseResponse() sobre uma base partilhada RateProvider.

get_rate_provider() faz corresponder o valor da opção a um nome de classe; se não existir classe, wpcs_add_aggregator_processor permite a um site ligar a sua própria fonte, e wpcs_announce_aggregator acrescenta-a à lista das definições. A lista das definições tem 14 fontes.

O BCE publica em relação ao EUR, o Banco Nacional da Ucrânia em relação à UAH, o Magyar Nemzeti Bank em relação ao HUF. Cada fornecedor trata três casos: a base é a moeda do banco, o destino é a moeda do banco, nenhum dos dois. A fonte MNB é um serviço SOAP com decimais em vírgula e cotações por unidade (por exemplo 100 JPY), normalizadas antes da divisão.

get_rate() devolve o texto de erro do fornecedor em vez de um número quando a taxa é negativa. rate_auto_update() converte os resultados para float e só substitui uma taxa quando o novo valor é superior a zero, pelo que uma fonte avariada nunca grava zero nem um texto de erro como taxa.

As definições oferecem de hora a hora, duas vezes por dia, diário, semanal ou mensal. O plugin regista os dois intervalos adicionais através de cron_schedules e agenda o evento com o intervalo selecionado no carregamento, quando ainda não está agendado.

O handler AJAX guarda o novo indicador is_etalon, define a nova moeda predefinida em memória, pede uma taxa para cada uma das outras moedas através do fornecedor ativo e devolve as taxas ao formulário de definições.

WPCS_World_Currencies guarda símbolo, descrição, decimais e código de bandeira por moeda. add_currencies_ajax() adiciona as selecionadas, obtém uma taxa para cada uma, regista símbolos desconhecidos como sinais personalizados e descarrega a bandeira para a biblioteca de multimédia, recorrendo a um URL remoto de bandeira se a transferência falhar. A caixa de diálogo de adição em massa só é mostrada na build premium.

Cada span de preço leva um ID único e o montante base. Com a opção de cache ativa, front.js envia os pares id/montante para wpcs_get_prices_html, que resolve a moeda do visitante no servidor e devolve um mapa de id para novo HTML mais a moeda atual; os widgets do seletor são depois sincronizados com ela. O modo existe no código de 2016.

Enquanto os widgets do seletor estão a ser definidos para a moeda devolvida, um indicador impede que os seus eventos de mudança iniciem outra troca de moeda.

WPCS_STORAGE constrói o backend pelo nome a partir de uma classe abstrata Storage. SessionStorage::create() devolve false quando session_start() falha, e o wrapper recorre então ao armazenamento em transient. Cada valor é sanitizado na escrita.

O changelog indica o motivo: os transients indexados por IP misturam utilizadores que partilham um endereço. CookieStorage indexa os transients por um cookie UUID. Se os cabeçalhos já tiverem sido enviados quando o ID é criado, imprime um script no rodapé que envia o ID para um endpoint AJAX verificado por nonce, o qual define o cookie a partir de uma resposta limpa.

No modo predefinido, wpcs_redirect() reconstrói o URL atual mantendo os outros parâmetros GET e a âncora #. No modo 'No GET data in link', envia a moeda para wpcs_set_currency_ajax e recarrega. Os parâmetros GET repetidos no script da página são primeiro sanitizados recursivamente.

No primeiro pedido, a moeda de boas-vindas é guardada e o indicador é definido; as regras geográficas também só correm numa primeira visita única. Se uma moeda guardada for removida da lista mais tarde, get_currencies() recorre à base.

O WC_Geolocation do WooCommerce não está disponível num site WordPress simples, pelo que o plugin traz a sua própria base de dados de países. lib/GeoIP.dat e geoip.inc são envolvidos em OpenIpCountryResolver com uma cache por IP em cada pedido.

Com a base de dados incluída, um cabeçalho HTTP_CF_IPCOUNTRY da Cloudflare é usado diretamente e a consulta à base de dados é ignorada. Um pedido cujo REMOTE_ADDR seja 127.0.0.1 ou ::1 é resolvido como 8.8.8.8 antes de os cabeçalhos de proxy serem lidos.

Com uma chave de licença MaxMind, o administrador descarrega o arquivo GeoLite2-Country; o handler descompacta o .tar.gz com PharData, encontra o ficheiro .mmdb, copia-o para uploads/currency-switcher e remove os ficheiros temporários em caso de êxito e de erro. Sem chave, o plugin mantém-se na base de dados incluída. As consultas passam pelo pacote Composer geoip2.

init_geo_currency() resolve o país, passa-o por wpcs_geo_position, guarda-o para o visitante e aplica a primeira regra correspondente apenas numa primeira visita. [wpcs_check_country] imprime o país detetado para depurar uma regra.

wpcs_get_prices_html está disponível para visitantes anónimos. Corta a entrada para 500 registos, aceita apenas ids que correspondam ao conjunto de caracteres de uniqid() usado por price_html(), ignora preços não escalares e codifica a resposta com JSON_HEX_TAG, AMP, APOS e QUOT porque o admin-ajax a serve como text/html.

price_html() escreve valores que vêm dos atributos de [wpcs_price], como o montante base ou a lista em bruto 'USD:15,EUR:20' de um preço fixo, em atributos data-* do span de preço. As chaves e os valores são escapados e colocados entre aspas, pelo que um valor de atributo não pode injetar marcação.

wpcs_rates_current_currency passa entrada do visitante para do_shortcode(). Só sobrevivem os códigos de moeda que existem na configuração, o resultado passa por esc_attr, e a precisão é convertida para int, pelo que não pode ser injetada sintaxe de shortcode adicional.

O campo do formulário do seletor de moeda e o parâmetro ?currency= são verificados com array_key_exists() em relação à lista configurada antes de chegarem ao armazenamento, e WPCS_STORAGE::set_val() sanitiza todos os valores.

Símbolos como руб. são guardados como entidades. O select envia md5(símbolo), e o handler de gravação mapeia o hash de volta para a entidade original da lista conhecida, de modo que a entidade não é codificada duas vezes nem tomada da entrada em bruto. A gravação é protegida por check_admin_referer(), e a posição é verificada em relação a uma lista fixa.