{"id":255,"date":"2020-02-05T06:36:15","date_gmt":"2020-02-05T06:36:15","guid":{"rendered":"https:\/\/stockpack.co\/blog\/?p=255"},"modified":"2022-11-02T19:09:05","modified_gmt":"2022-11-02T19:09:05","slug":"changing-the-automated-captions","status":"publish","type":"post","link":"https:\/\/stockpack.co\/blog\/changing-the-automated-captions\/","title":{"rendered":"Changing the automated captions"},"content":{"rendered":"\n

In the book “Don’t make me think<\/a>” by Steve Krug, there’s an explanation about the fact that humans are quite likely to scan an article instead of reading it. <\/p>\n\n\n\n

While scanning your article the parts that stand out are the ones that are more unique. That includes images and captions, as captions are normally in a different<\/strong> style<\/em>. <\/p>\n\n\n\n\n\n\n\n

\"Unique
Photo by Cristina Gottardi<\/a> on Unsplash<\/a><\/figcaption><\/figure>\n\n\n\n

Unique captions<\/h2>\n\n\n\n

You should aim to be unique as much as possible, as unique<\/strong> stands out. To support that, we are allowing an easy way to customize the captions in WordPress. <\/p>\n\n\n\n

There is a filter available named suggestively: stockpack_caption<\/code><\/p>\n\n\n\n

This filter allows translating or modifying the format of the caption. The default WordPress caption looks like this (end lines added for readability<\/em>):<\/p>\n\n\n\n

<\/path><\/svg><\/div>
Photo by \n<a href=\"http:\/\/provider.com\/author-url-here\">\n    John Doe\n<\/a> \non \n<a href=\"http:\/\/provider.com\/image-url-goes-here\">\n    FavoriteProvider\n<\/a><\/pre><\/div>\n\n\n\n
That is the code, here’s how that renders: Photo by Cristina Gottardi<\/a> on Unsplash<\/a><\/em><\/p>\n\n\n\n
Setting your own caption<\/h2>\n\n\n\n
If you are not familiar with code, we got you covered<\/a>. Currently, you need to parse that caption, as the data is not available separately, but in time that might change. Here’s an example:<\/p>\n\n\n\n
<?php\nfunction change_stockpack_caption_format( $caption, $image ) {\n\tif ( $caption === '' ) {\n\t\treturn $caption;\n\t}\n\t$chunks = explode( \"<\", $caption );\n\t$author= explode( \">\", $chunks[1] );\n\n\n\treturn \"Via <$chunks[3]<\/a> \/ $author[1] \";\n}\n\nadd_filter( 'stockpack_caption', 'change_stockpack_caption_format', 20, 2 );<\/pre><\/div>\n\n\n\n
This function removed the author URL, and displays only the image URL, while mentioning the author. Since users can easily get the author from the image URL this should be just fine. <\/p>\n\n\n\n
Here’s how that renders: Via Unsplash<\/a><\/em> \/ Cristina Gottardi<\/em><\/p>\n\n\n\n
Going further<\/h2>\n\n\n\n
If you have a specific caption format you need for your WordPress website, and you can’t get it working on your own, feel free to reach out. We’d be glad to help. <\/p>\n\n\n\n
If you are looking for some tricks to help you stand out with your images check this article: 5 simple image tricks that go a long way in WordPress<\/a><\/p>\n\n\n\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
In the book “Don’t make me think” by Steve Krug, there’s an explanation about the fact that humans are quite likely to scan an article instead of reading it. While scanning your article the parts that stand out are the ones that are more unique. That includes images and captions, as captions are normally in … Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":256,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[23,11,7,4,8],"tags":[],"class_list":["post-255","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-documentation","category-help","category-images","category-tutorial","category-wordpress"],"_links":{"self":[{"href":"https:\/\/stockpack.co\/blog\/wp-json\/wp\/v2\/posts\/255","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/stockpack.co\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/stockpack.co\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/stockpack.co\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/stockpack.co\/blog\/wp-json\/wp\/v2\/comments?post=255"}],"version-history":[{"count":5,"href":"https:\/\/stockpack.co\/blog\/wp-json\/wp\/v2\/posts\/255\/revisions"}],"predecessor-version":[{"id":572,"href":"https:\/\/stockpack.co\/blog\/wp-json\/wp\/v2\/posts\/255\/revisions\/572"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/stockpack.co\/blog\/wp-json\/wp\/v2\/media\/256"}],"wp:attachment":[{"href":"https:\/\/stockpack.co\/blog\/wp-json\/wp\/v2\/media?parent=255"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/stockpack.co\/blog\/wp-json\/wp\/v2\/categories?post=255"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/stockpack.co\/blog\/wp-json\/wp\/v2\/tags?post=255"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}