Plugin SVN e atualização API - como os plugins são identificados?

Ao enviar um plug-in, o slug se torna o nome do plug-in higienizado, conforme enviado. O "Nome" do plugin pode mudar depois disso, mas o slug permanece o mesmo para sempre.

Quando o WordPress precisa verificar se há uma atualização de plug-in, ele obtém todas as informações de cabeçalho do plug-in e o nome do diretório no qual o plug-in está e o envia para o WordPress.org.

Três fatores são usados atualmente para tentar fazer uma correspondência com os plug-ins no diretório. Note que eu digo "atualmente", porque isso muda sempre que tentamos melhorar os algoritmos de correspondência.

1. O nome do diretório de plugins é geralmente o "slug" do plugin. Pelo menos, é se você instalou a partir do diretório para começar. Então, nós procuramos por um slug com o nome do diretório. Este não é um ótimo indicador, mas ajuda.

2. O "Nome" no cabeçalho do plug-in também é procurado, pois o Nome deve ser exclusivo no diretório do plug-in. Se não houver correspondência nesse nome exato, o Nome será limpo para produzir uma lesma e também procuraremos essa lesma por precaução. Isso nem sempre funciona.

3. O "Plugin URI" no cabeçalho também é verificado para uma correspondência. Como sabemos esse valor para todos os plug-ins no diretório, isso pode ser considerado razoavelmente exclusivo para cada plug-in. Assim, os autores de plugins devem inserir um URI de plug-in que aponte para um domínio que eles controlam e um URL exclusivo para o plug-in.

Todos esses três fatores são ponderados e o resultado principal é retornado. Os pesos usados para cada um dos três refletem um nível de confiança na precisão dos dados. Por exemplo, Name tem um peso maior que o plugin-directory-as-slug, porque a maioria dos autores não altera os nomes dos plugins com muita frequência, e o plugin-directory pode ser qualquer coisa se o usuário instalá-lo manualmente ou algo do tipo.

Quanto mais próxima a correspondência desses três itens, mais provável é que isso corresponda ao plug-in. Mas pelo menos uma correspondência exata deve ser encontrada para que qualquer resultado seja retornado.

Para plug-ins personalizados, costumo usar o nome do site no próprio nome do plug-in. Isso me ajuda com a organização também. Então meu nome de plugin único pode ser "ottopress.com - Corrigir problema com o que quer que seja". É improvável que qualquer plug-in no diretório corresponda ao seu domínio.

Como a entrada SVN é obviamente criada antes de você enviar seu plug-in pela primeira vez, ela é baseada em sua solicitação inicial de entrada. Não sei se o processo é técnico ou manual, provavelmente um pouco de ambos.

Para fins de atualização, várias informações são enviadas e o repositório tenta determinar a correspondência com base no nome do plug-in, nome do diretório, versão atual e possivelmente mais. Não sei se um algoritmo exato já foi publicado.