xF2 Add-on CinVin: Style & Meta Tweaks (use attachments for og:image & others) 1.1

This is a collection of several options related to XenForo meta tags and miscellaneous display tweaks. This is how, for example, we are using attachments for the og:image at Cameraderie photography forum.

After installing go into your XF Options page and look for "CinVin - Style Tweaks" to change your settings.

Change "What's New" Icon Link to "New Posts"
On mobile devices (small screen sizes) a "What's New" lightning bolt icon is shown in the navigation bar. By default this links to the "What's New" page. This option changes the link to "New Posts" instead.

Change Emoji CDN File Extension
When using a custom "Emoji Source" location the files are hard-coded for the png extension. This option allow you to select a different extension such as svg. (See thread 177937 at XenForo.com for reference.)

Add Back Icon on Mobile
On mobile devices (small screen sizes) a new 'back' icon can be shown in the navigation bar. This can be seen in action here at Alien Soup and at our sister sites like Cameraderie.


Unfurl Description Length
Enter the maximum length to use for the text of unfurled URLs. The default value is hard-coded in the bb_code_tag_url_unfurl template. Enter a new maxium length value here or leave it as 0 to use the XF default value from the template. (See thread 161444 at XenForo.com for reference.)

Use Post Attachment for OG:Image and use Twitter Card [meta tags og:image, og:image:height, og:image:width and twitter:card]
By default value of the og:image is the value entered for the Metadata logo URL in your style templates under Basic Options. When posting to social media like Twitter and Facebook using a post attachment image instead is usually preferred. Turn this option on to use try to use an attachment instead. Enabling this option will also include the meta tag twitter:card using the card type specified. If you are unsure what value to use then leave it at summary_large_image. If no attachment image is available to use then the default XF value will be used. (See Metadata logo URL in ACP.)
*** GUESTS NEED PERMISSIONS TO VIEW ATTACHMENTS IN ORDER TO USE AN ATTACHMENT AS THE OG:IMAGE! ***

Use the calculated XF 'article' cover image for the OG:Image if no post attachments are found [meta tags og:image]
If the option to use a post attachment does not find any matching attachments or if the option is turned off then this option will use the XF calculated 'article' cover image as the og:image value. Doing this has concerns that need to be taken into account. If guests do not have permissions to view attachments and if an attachment is found then the thumbnail will be used. If no image attachment is found then it will use the URL of an embedded image. When using the cover image function, whether it is an attachment, thumbnail, or remote image, the dimensions of the selected image are not checked to see if they meet the requirements for use by Twitter and Facebook. The option is there but should only be turned on if you are really sure about it.

Use the Metadata Logo as the XF 'article' cover image if no images are found
When threads are listed using the XF 'article' template it uses 'cover image' function to find an image to be be displayed. If no image is found then this option will use the Metadata Logo for the article cover image so that all threads are displayed in the listing with an image.

Changes the XF 'article' phrase View full article to the phrase View more
Several add-ons, such as [CinVin] Featured Threads, use the XF 'article' view for listing threads. When used in different add-ons the default phrase used for the link to the view the full thread is View full article but the thread might not be an article thread type. Turning this option on will change the template to use the View more phrase instead.

Twitter Site Name [meta tag twitter:site]
Enter a Twitter account name to include in the meta tags as the twitter:site value. This meta tag is required when specifying the Twitter Card to be certain types like summary_large_image. This is typically the same value you would have used for the Twitter Connected Accounts value. (See Twitter Card Tags for reference.)

Facebook App ID [meta tag fb:app_id]
Enter your Facebook Application ID. This is typically the same value you would have used for the Facebook Connected Accounts value. Having the Facebook Application ID is required in order to gather statistics with Facebook Insights. If you do not use/care about FB Insights then this value will not affect you if it is missing. XenForo will not add the meta tag back. (See thread 164982 at XenForo.com for reference.)

Page "Type" for Thread View [meta tag og:type]
The default Open Graph value for XenForo pages is "website" on all pages. Enter a different value, such as "article", to use on Thread View pages. Be sure the value you enter is valid and that you are absolutely sure you want to change it. This will be used on Thread View pages only, the rest of your XenForo pages will still use the XF default. Leave this blank to use the default XF value. A value of article or blog is required for use with Pinterest Rich Pins. (See Pinterest Article Pins for reference.)