{"id":231292,"date":"2022-12-17T12:38:00","date_gmt":"2022-12-17T09:38:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=231292"},"modified":"2022-12-07T11:45:03","modified_gmt":"2022-12-07T08:45:03","slug":"adicionando-um-link-de-configuracoes-de-plug-in","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/adicionando-um-link-de-configuracoes-de-plug-in\/","title":{"rendered":"Adicionando um link de configura\u00e7\u00f5es de plug-in"},"content":{"rendered":"

Sempre que voc\u00ea estiver construindo um plugin que introduz um submenu e estiver usando as APIs apropriadas, estar\u00e1 criando uma p\u00e1gina de administra\u00e7\u00e3o (com ou sem configura\u00e7\u00f5es).<\/p>\n

Ao fazer isso, por\u00e9m, voc\u00ea tamb\u00e9m pode introduzir um link de configura\u00e7\u00f5es do plugin. Esses s\u00e3o os links que aparecem sob o nome do plug-in no painel do plug-in.<\/p>\n

Se o seu plug-in apresentar seu item de submenu, provavelmente apresentar\u00e1 sua pr\u00f3pria p\u00e1gina de configura\u00e7\u00f5es. E se voc\u00ea deseja associar esta p\u00e1gina ao link de configura\u00e7\u00f5es do plug-in, \u00e9 muito f\u00e1cil de fazer.<\/p>\n

Link de configura\u00e7\u00f5es do plug-in<\/h2>\n

Primeiro, pode ser \u00fatil revisar o gancho plugin_action_links<\/a> que o WordPress fornece.<\/p>\n

\"Adicionando<\/a><\/p>\n

Como diz o Codex:<\/p>\n

\n

Aplicado \u00e0 lista de links a serem exibidos na p\u00e1gina de plugins (ao lado dos links de ativa\u00e7\u00e3o\/desativa\u00e7\u00e3o).<\/p>\n<\/blockquote>\n

A partir da\u00ed, voc\u00ea precisar\u00e1 definir sua fun\u00e7\u00e3o e criar um link para a p\u00e1gina de configura\u00e7\u00f5es.<\/p>\n

Tudo que voc\u00ea precisa saber \u00e9 o seguinte:<\/p>\n

    \n
  1. a fun\u00e7\u00e3o de retorno de chamada aceita uma matriz de links que ir\u00e1 renderizar,<\/li>\n
  2. o URL para sua p\u00e1gina de configura\u00e7\u00f5es<\/li>\n<\/ol>\n

    A partir da\u00ed, basta adicionar um link \u00e0 p\u00e1gina de configura\u00e7\u00f5es do plug-in e adicionar o link \u00e0 matriz de entrada. Ent\u00e3o voc\u00ea retorna essa matriz para o WordPress.<\/p>\n

    Veja como<\/a> :<\/p>\n

    <?php\nadd_filter('plugin_action_links_'. plugin_basename(__FILE__), __NAMESPACE__. 'acme_settings_link' );\n\/**\n * Creates a Settings link that links the users directly to the Settings page from the admin\n * screen.\n *\n * @param array $links The list of links to appear under the plugin title.\n * @return array $links The updated array of links including the 'Settings' link.\n *\/\nfunction acme_settings_link($links) {\n\n    \/\/ Build the URL.\n    $url = add_query_arg(\n        'page',\n        'acme-plugin',\n        get_admin_url(). 'admin.php'\n    );\n\n    \/\/ Create the link.\n    $settings_link = \"<a href='$url'>\". __( 'Settings' ). '<\/a>';\n\n    \/\/ Adds the link to the end of the array.\n    array_push(\n        $links,\n        $settings_link\n    );\n\n    return $links;\n}<\/code><\/pre>\n
    E \u00e9 isso.<\/p>\n
    Se voc\u00ea quiser mudar onde o link est\u00e1 localizado, voc\u00ea pode coloc\u00e1-lo em outro lugar no array usando uma das muitas fun\u00e7\u00f5es do array PHP<\/a> (ou at\u00e9 mesmo mudando onde est\u00e1 especificado na fun\u00e7\u00e3o acima (primeiro ou \u00faltimo).<\/p>\n
    A partir daqui, por\u00e9m, o link de configura\u00e7\u00f5es do plug-in aparecer\u00e1 na p\u00e1gina do plug-in na \u00e1rea de administra\u00e7\u00e3o do WordPress.<\/p>\n
    Fonte de grava\u00e7\u00e3o:  tommcfarlin.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
    Se o seu plug-in apresentar seu item de submenu, provavelmente apresentar\u00e1 uma p\u00e1gina de configura\u00e7\u00f5es. E se voc\u00ea deseja introduzir um link de configura\u00e7\u00f5es de plug-in, \u00e9 f\u00e1cil de fazer.<\/p>\n","protected":false},"author":1,"featured_media":236170,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[898,722,867],"tags":[1170],"class_list":["post-231292","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-codigo-2","category-desenvolvedor","category-wordpress-8","tag-affiai-pt-pt"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/231292","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/comments?post=231292"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/231292\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media\/236170"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=231292"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/categories?post=231292"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/tags?post=231292"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}