{"id":25,"date":"2014-01-23T00:43:51","date_gmt":"2014-01-23T00:43:51","guid":{"rendered":"https:\/\/zedejose.com\/?p=25"},"modified":"2018-10-13T12:34:39","modified_gmt":"2018-10-13T11:34:39","slug":"dear-wp-job-manager-need-talk","status":"publish","type":"post","link":"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/","title":{"rendered":"Dear WP Job Manager: We Need to Talk"},"content":{"rendered":"<h3>It&#8217;s not you, it&#8217;s me<\/h3>\n<p>Let me get the obvious out of the way, so that we can focus on what&#8217;s important in mending this relationship: <a href=\"http:\/\/mikejolley.com\/projects\/wp-job-manager\/\">I love you<\/a>, I do. The way you blend into my site&#8217;s dashboard sends shivers of joy every time I open your settings page, and your Ajax-powered search and refresh make me swoon like a teenager anticipating getting to third base for the first time in his life. I was even a little naughty and looked at the source code and was amazed at the simple and efficient beauty of what is&#8230; erm&#8230; under the hood.<\/p>\n<p>Truth be told, this may very well not even be a problem in our relationship, specifically; I suspect that, should I ever get as intimate with a plugin as I have with you, I would most likely have the same issues and suffered their same indifference (feigned? deliberate? unconscious? We&#8217;ll never know) in silence. My brief affairs with many other plugins made me often suspect that they too had a problem, but the one with you is one I don&#8217;t want to abandon: we&#8217;re meant to be together, and I can&#8217;t delay opening my heart to you any longer, nor can I any longer just hint at it with simple remarks on GitHub. Tough love, they call it.<\/p>\n<h3>You have a problem with .pot<\/h3>\n<p>Look, I understand: the happy buzz of seeing your code running in hundreds of languages is irresistible. I bet it gives you the munchies, even. And you&#8217;re doing it right, too: there is the soothing call to <code>load_plugin_textdomain<\/code>, and a sexy <code>\/languages<\/code> folder.<\/p>\n<p>But&#8230;<\/p>\n<ul>\n<li>It&#8217;s true that that you even have proper <code>job_manager.pot<\/code> file, but sadly, it is not properly named, i.e. it should match the plugin&#8217;s slug. Notice &#8220;should&#8221; and not &#8220;has to&#8221;. I don&#8217;t mean to be fussy, and I&#8217;ll just say that this is really <a href=\"http:\/\/ottopress.com\/2013\/language-packs-101-prepwork\/\">Otto&#8217;s fault<\/a>, who has much higher standards than myself, all with his language packs and things.<\/li>\n<li>He&#8217;s also the one who would tell you to add <code>Domain Path: \/languages<\/code> and\u00a0<code>Text Domain: wp-job-manager<\/code> in your code&#8217;s header. Not I, oh no! I know you would have to change every single <code>_e()<\/code> and <code>__()<\/code> call&#8217;s textdomain from <code>job_manager<\/code> to <code>wp-job-manage<\/code>r, and how that would mean slower updates for me. He <a href=\"http:\/\/wceu2013.ottopress.com\/\">means well<\/a>, but I like updates.<\/li>\n<\/ul>\n<p>Relax, I&#8217;m not breaking up with you. At least not as long as we can talk about the way you&#8217;re growing your .pot. You see, every time you update, and even though I translate every single string there, I still see many strings in English. This, in turn, invariably makes me suspect that the .pot is old, dry if you will, and forces me to <a href=\"http:\/\/i18n.svn.wordpress.org\/tools\/trunk\/\">run <code>makepot.php<\/code><\/a> on your code every time, and every time it results in a .pot that&#8217;s different (fresher!) than yours. Lo and behold, if I translate that new file, everything shows up as it should, in that sweet, sweet Portuguese that you like so much.<\/p>\n<h3>We can fix this as if it were 4:20<\/h3>\n<p>It&#8217;s really, really simple: you&#8217;re a modern, independent and strong-willed plugin, and I&#8217;m sure you use Grunt or some other build tool which embraces your <code>.less<\/code> and cuddles your <code>.js<\/code>, right? If you don&#8217;t, you can always use a <code>cron<\/code> or even do it by hand, but the important thing is to automate the harvesting: in other words, before new code gets committed, <span style=\"text-decoration: underline;\">every single time<\/span>, the .pot needs to be updated to reflect it. Automation means set once and forget, and it will make the rest of the non-English speaking world eventually fall for you in the same way that I have: hopelessly.<\/p>\n<p>xoxo<br \/>\nZ\u00e9<\/p>\n<p><strong>Update<\/strong>:<\/p>\n<p>It looks like you were listening after all, and there I was thinking that your sudden interest in Arsenal&#8217;s score was but a ruse to not having to think about it. For those interested, here&#8217;s what happened to the plantation:<\/p>\n<ul>\n<li><a href=\"https:\/\/github.com\/mikejolley\/WP-Job-Manager\/commit\/41c6b228f51f6423e1820f6e0dcc39c92804e0a0\">Textdomains were updated<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/mikejolley\/WP-Job-Manager\/commit\/5128ed1a129d9495211bb9d4cecbd4102f6a8e6a\">Translation files were renamed<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/mikejolley\/WP-Job-Manager\/commit\/3e81c8cc80881ec54881cc4f8f899f39f3b2f3ef\">Plugin headers were added<\/a><\/li>\n<li>Also (even if it&#8217;s not visible on GitHub), automation was implemented to run <code>makepot.php<\/code> before any commit. This is done via a <a href=\"http:\/\/www.git-scm.com\/book\/en\/Customizing-Git-Git-Hooks\">pre-commit hook<\/a> (how modern!), that runs a script based on this <a href=\"https:\/\/gist.github.com\/johnpbloch\/3436835\">very smart solution<\/a> by John P. Bloch.<\/li>\n<\/ul>\n<p>We have fresh .pot!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>It&#8217;s not you, it&#8217;s me Let me get the obvious out of the way, so that we can focus on what&#8217;s important in mending this relationship: I love you, I do. The way you blend into my site&#8217;s dashboard sends shivers of joy every time I open your settings page, and your Ajax-powered search and [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8],"tags":[9,11,12,10],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v22.5 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Dear WP Job Manager: We Need to Talk &#8212; Z\u00e9 Fontainhas<\/title>\n<meta name=\"description\" content=\"Dear WP Job Manager, you have a problem with .pot\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/\" \/>\n<meta property=\"og:locale\" content=\"en_GB\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Dear WP Job Manager: We Need to Talk &#8212; Z\u00e9 Fontainhas\" \/>\n<meta property=\"og:description\" content=\"Dear WP Job Manager, you have a problem with .pot\" \/>\n<meta property=\"og:url\" content=\"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/\" \/>\n<meta property=\"og:site_name\" content=\"Z\u00e9 Fontainhas\" \/>\n<meta property=\"article:published_time\" content=\"2014-01-23T00:43:51+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2018-10-13T11:34:39+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/zedejose.com\/wp-content\/uploads\/2018\/10\/FB.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"630\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Z\u00e9\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@zedejose\" \/>\n<meta name=\"twitter:site\" content=\"@zedejose\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Z\u00e9\" \/>\n\t<meta name=\"twitter:label2\" content=\"Estimated reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/\"},\"author\":{\"name\":\"Z\u00e9\",\"@id\":\"https:\/\/zedejose.com\/#\/schema\/person\/de2b07d2344d57affa53634beebc8083\"},\"headline\":\"Dear WP Job Manager: We Need to Talk\",\"datePublished\":\"2014-01-23T00:43:51+00:00\",\"dateModified\":\"2018-10-13T11:34:39+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/\"},\"wordCount\":728,\"commentCount\":2,\"publisher\":{\"@id\":\"https:\/\/zedejose.com\/#\/schema\/person\/de2b07d2344d57affa53634beebc8083\"},\"keywords\":[\"i18n\",\"makepot.php\",\"textdomain\",\"WP Job Manager\"],\"articleSection\":[\"Plugins\"],\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/\",\"url\":\"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/\",\"name\":\"Dear WP Job Manager: We Need to Talk &#8212; Z\u00e9 Fontainhas\",\"isPartOf\":{\"@id\":\"https:\/\/zedejose.com\/#website\"},\"datePublished\":\"2014-01-23T00:43:51+00:00\",\"dateModified\":\"2018-10-13T11:34:39+00:00\",\"description\":\"Dear WP Job Manager, you have a problem with .pot\",\"breadcrumb\":{\"@id\":\"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/#breadcrumb\"},\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/zedejose.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Dear WP Job Manager: We Need to Talk\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/zedejose.com\/#website\",\"url\":\"https:\/\/zedejose.com\/\",\"name\":\"Z\u00e9 Fontainhas\",\"description\":\"on WordPress and things\",\"publisher\":{\"@id\":\"https:\/\/zedejose.com\/#\/schema\/person\/de2b07d2344d57affa53634beebc8083\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/zedejose.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-GB\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\/\/zedejose.com\/#\/schema\/person\/de2b07d2344d57affa53634beebc8083\",\"name\":\"Z\u00e9\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/zedejose.com\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/aac7e0386facd070f6d4b817c257a958?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/aac7e0386facd070f6d4b817c257a958?s=96&d=mm&r=g\",\"caption\":\"Z\u00e9\"},\"logo\":{\"@id\":\"https:\/\/zedejose.com\/#\/schema\/person\/image\/\"},\"description\":\"I am a WordPress project manager, consultant, back-end developer, and speaker. I am also a drummer, and a mixer of cocktails.\",\"sameAs\":[\"https:\/\/zedejose.com\",\"https:\/\/www.instagram.com\/ze.fontainhas\/\",\"https:\/\/www.linkedin.com\/in\/josefontainhas\/\",\"https:\/\/x.com\/zedejose\"],\"url\":\"https:\/\/zedejose.com\/author\/zedejose\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Dear WP Job Manager: We Need to Talk &#8212; Z\u00e9 Fontainhas","description":"Dear WP Job Manager, you have a problem with .pot","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/","og_locale":"en_GB","og_type":"article","og_title":"Dear WP Job Manager: We Need to Talk &#8212; Z\u00e9 Fontainhas","og_description":"Dear WP Job Manager, you have a problem with .pot","og_url":"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/","og_site_name":"Z\u00e9 Fontainhas","article_published_time":"2014-01-23T00:43:51+00:00","article_modified_time":"2018-10-13T11:34:39+00:00","og_image":[{"width":1200,"height":630,"url":"https:\/\/zedejose.com\/wp-content\/uploads\/2018\/10\/FB.png","type":"image\/png"}],"author":"Z\u00e9","twitter_card":"summary_large_image","twitter_creator":"@zedejose","twitter_site":"@zedejose","twitter_misc":{"Written by":"Z\u00e9","Estimated reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/#article","isPartOf":{"@id":"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/"},"author":{"name":"Z\u00e9","@id":"https:\/\/zedejose.com\/#\/schema\/person\/de2b07d2344d57affa53634beebc8083"},"headline":"Dear WP Job Manager: We Need to Talk","datePublished":"2014-01-23T00:43:51+00:00","dateModified":"2018-10-13T11:34:39+00:00","mainEntityOfPage":{"@id":"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/"},"wordCount":728,"commentCount":2,"publisher":{"@id":"https:\/\/zedejose.com\/#\/schema\/person\/de2b07d2344d57affa53634beebc8083"},"keywords":["i18n","makepot.php","textdomain","WP Job Manager"],"articleSection":["Plugins"],"inLanguage":"en-GB","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/","url":"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/","name":"Dear WP Job Manager: We Need to Talk &#8212; Z\u00e9 Fontainhas","isPartOf":{"@id":"https:\/\/zedejose.com\/#website"},"datePublished":"2014-01-23T00:43:51+00:00","dateModified":"2018-10-13T11:34:39+00:00","description":"Dear WP Job Manager, you have a problem with .pot","breadcrumb":{"@id":"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/#breadcrumb"},"inLanguage":"en-GB","potentialAction":[{"@type":"ReadAction","target":["https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/zedejose.com\/dear-wp-job-manager-need-talk\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/zedejose.com\/"},{"@type":"ListItem","position":2,"name":"Dear WP Job Manager: We Need to Talk"}]},{"@type":"WebSite","@id":"https:\/\/zedejose.com\/#website","url":"https:\/\/zedejose.com\/","name":"Z\u00e9 Fontainhas","description":"on WordPress and things","publisher":{"@id":"https:\/\/zedejose.com\/#\/schema\/person\/de2b07d2344d57affa53634beebc8083"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/zedejose.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-GB"},{"@type":["Person","Organization"],"@id":"https:\/\/zedejose.com\/#\/schema\/person\/de2b07d2344d57affa53634beebc8083","name":"Z\u00e9","image":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/zedejose.com\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/aac7e0386facd070f6d4b817c257a958?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/aac7e0386facd070f6d4b817c257a958?s=96&d=mm&r=g","caption":"Z\u00e9"},"logo":{"@id":"https:\/\/zedejose.com\/#\/schema\/person\/image\/"},"description":"I am a WordPress project manager, consultant, back-end developer, and speaker. I am also a drummer, and a mixer of cocktails.","sameAs":["https:\/\/zedejose.com","https:\/\/www.instagram.com\/ze.fontainhas\/","https:\/\/www.linkedin.com\/in\/josefontainhas\/","https:\/\/x.com\/zedejose"],"url":"https:\/\/zedejose.com\/author\/zedejose\/"}]}},"_links":{"self":[{"href":"https:\/\/zedejose.com\/wp-json\/wp\/v2\/posts\/25"}],"collection":[{"href":"https:\/\/zedejose.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/zedejose.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/zedejose.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/zedejose.com\/wp-json\/wp\/v2\/comments?post=25"}],"version-history":[{"count":0,"href":"https:\/\/zedejose.com\/wp-json\/wp\/v2\/posts\/25\/revisions"}],"wp:attachment":[{"href":"https:\/\/zedejose.com\/wp-json\/wp\/v2\/media?parent=25"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/zedejose.com\/wp-json\/wp\/v2\/categories?post=25"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/zedejose.com\/wp-json\/wp\/v2\/tags?post=25"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}