This demo showcases how Document Gallery displays your documents in a beautiful, gallery-style format. Below you will see automatically generated thumbnails for PDF files.<\\\/p>\\n\\n\\n\\n
Click any document thumbnail to open the file!<\\\/p>\\n'; $page_id = wp_insert_post([ 'post_title' => 'Document Gallery Demo', 'post_content' => $page_content, 'post_status' => 'publish', 'post_type' => 'page' ]); update_option('page_on_front', $page_id); update_option('show_on_front', 'page');\"},{\"step\":\"runPHP\",\"code\":\"ids<\/code> attribute). It also shows how images will appear in a Document\nGallery. Note that the description field supports HTML markup, so the\npossibilities are endless!","5":"This is how the Document Gallery looks with Display your documents beautifully! Document Gallery creates thumbnail galleries for PDFs, Word documents, PowerPoint presentations, and other file types\u2014just like WordPress does for images.<\/p>\n\n Click the '+' button in the editor and search for \"Document Gallery\" to insert a gallery block. All configuration options appear in the sidebar\u2014no shortcode knowledge required. Select specific documents or let the gallery auto-populate based on your criteria.<\/p>\n\n The classic Document Gallery provides extensive filters and actions for customizing thumbnail generation, HTML output, and gallery queries. See the Installation tab for complete developer documentation.<\/p>\n\n Document Gallery has to-date been translated into 6<\/strong> languages, listed below.<\/p>\n\n Document Gallery includes features intended to make integration with other plugins\nsimple. See the bottom of the Installation<\/strong> tab for specific documentation on\nthe various features provided.<\/p>\n\n If this plugin has helped you, please take a moment to rate it<\/a>!<\/em><\/p>\n\n\n Block Editor (Recommended)<\/strong><\/p>\n\n Shortcode Method<\/strong><\/p>\n\n Add In order to include all compatible documents from a given page or post, you\nmust include the following shortcode in the post: In addition to the default behavior, the plugin provides many options to\ncustomize behavior with various attributes, some of which are shown below:<\/p>\n\n Though the shortcode above may seem far from \"short,\" none of the attributes are\nrequired and most users will find that the plugin meets your needs \"out of the box\"\nwithout any added attributes.<\/p>\n\n Default Values<\/strong><\/p>\n\n Default document gallery behavior can be configured in your dashboard under Attachment Page Option<\/strong> (New in Version 1.1)<\/em><\/p>\n\n This option determines whether each document icon will link to the actual file\nor to its attachment page. If you want the user to be able to click on the\nicon and directly receive the option to download then use Categories\/Custom Taxonomy Option<\/strong> (New in Version 1.4)<\/em><\/p>\n\n With the Columns Option<\/strong> (New in Version 3.0)<\/em><\/p>\n\n The columns option does what it sounds like -- sets how many columns to use in\nrendering your gallery. With Descriptions Option<\/strong><\/p>\n\n If Note: this will use the Fancy Option<\/strong> (New in Version 2.0)<\/em><\/p>\n\n If ID Option<\/strong> (New in Version 3.0)<\/em><\/p>\n\n This option indicates from which parent post\/page to retrieve attachments.\nIf not explicitly set, the default will be the post\/page where the shortcode\nis being used.<\/p>\n\n If you do not wish to filter by parent, IDs Option<\/strong> (New in Version 1.2)<\/em><\/p>\n\n This is an advanced option intended for experienced WordPress users. If this\noption is used, the plugin will ignore attached documents, instead including\nall attachments defined by the Note: If this attribute is used, order defaults to the order of IDs given\nrather than menu_order unless order is explicitly stated.<\/em><\/p>\n\n Images Option<\/strong> (New in Version 1.2)<\/em><\/p>\n\n This option will tell the plugin to include all images attached to to a page or\npost in addition to all documents.<\/p>\n\n Include\/Exclude Options<\/strong> (New in Version 3.0)<\/em><\/p>\n\n As the name suggests, these options allow for explicitly adding or removing\nmatched attachments in your gallery. Like with the IDs options above, these\noptions take a comma-delimited list of attachment IDs.<\/p>\n\n Limit Option<\/strong> (New in Version 2.3)<\/em><\/p>\n\n As the name suggests, this value will limit how many results are returned in the gallery.\nIf set to -1<\/em>, the limit is infinite.<\/p>\n\n MIME Types Option<\/strong> (New in Version 3.0)<\/em><\/p>\n\n This is a comma-delimited list of all\nMIME types<\/a>\nto be included in the gallery. Most users will not need to modify this value.<\/p>\n\n One example use-case would be to include images in your gallery (which are\nnot included by default). To do this, you would simply set\n mime_types=application,video,text,audio,image, where \"image\" is the only difference\nfrom the default value. You could also create a gallery which only includes PDFs\nby setting New Window Option<\/strong> (New in Version 3.2)<\/em><\/p>\n\n If true, clicking one of the documents in your gallery will open the target link in a new window\/tab.<\/p>\n\n Order Option<\/strong><\/p>\n\n This option works alongside the Orderby Option<\/strong><\/p>\n\n Relation Option<\/strong> (New in Version 1.4)<\/em><\/p>\n\n The relation option should only be used when also using the category or custom\ntaxonomy<\/em> option (see above).<\/p>\n\n When using multiple taxa this option allows you to decide whether the attachments\nreturned must match all of the different taxa specified (AND) or a minimum of one\ntaxa match (OR).<\/p>\n\n NOTE: This has no bearing on the relationship between different terms for a single\ntaxon (eg: The Default Document gallery will often fit quite well with whatever theme you\nare using. But, if you want to change things, Document Gallery makes that easy.\nJust navigate to descriptions=false<\/code> (default).\nNote that the display inherits styling from your active theme."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1346,9054,1980,1764,6585],"plugin_category":[50],"plugin_contributors":[79263,79264],"plugin_business_model":[],"class_list":["post-19647","plugin","type-plugin","status-publish","hentry","plugin_tags-attachments","plugin_tags-documents","plugin_tags-library","plugin_tags-pdf","plugin_tags-word","plugin_category-media","plugin_contributors-danrossiter","plugin_contributors-demur","plugin_committers-danrossiter","plugin_committers-demur"],"banners":[],"icons":{"svg":"https:\/\/ps.w.org\/document-gallery\/assets\/icon.svg?rev=983329","icon":"https:\/\/ps.w.org\/document-gallery\/assets\/icon.svg?rev=983329","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/document-gallery\/trunk\/screenshot-1.png?rev=3414845","caption":"All gallery options are accessible through the block settings sidebar,\nwith real-time preview updates as you make changes."},{"src":"https:\/\/ps.w.org\/document-gallery\/trunk\/screenshot-2.png?rev=3414845","caption":"Document Gallery integrates seamlessly with the WordPress Block Editor,\nproviding an intuitive interface for creating and configuring galleries."},{"src":"https:\/\/ps.w.org\/document-gallery\/trunk\/screenshot-3.png?rev=3414845","caption":"This is an example of \"fancy\" thumbnails. The images are a copy of the front\npage for each document."},{"src":"https:\/\/ps.w.org\/document-gallery\/trunk\/screenshot-4.png?rev=3414845","caption":"This is an example of multiple Document Galleries on a single page (using\nthe ids<\/code> attribute). It also shows how images will appear in a Document\nGallery. Note that the description field supports HTML markup, so the\npossibilities are endless!"},{"src":"https:\/\/ps.w.org\/document-gallery\/trunk\/screenshot-5.png?rev=3414845","caption":"This is how the Document Gallery looks with descriptions=false<\/code> (default).\nNote that the display inherits styling from your active theme."}],"raw_content":"\nKey Features<\/h4>\n\n
\n
[dg]<\/code> shortcode available for template use<\/li>\n<\/ul>\n\nPerfect For<\/h4>\n\n
\n
Block Editor Integration<\/h4>\n\n
Shortcode Support<\/h4>\n\n
[dg]<\/code> shortcode continues to work perfectly for template files, widgets, and power users who prefer code-based configuration. See the Installation tab for all available options.<\/p>\n\nDeveloper Friendly<\/h4>\n\n
Partners<\/h4>\n\n
\n
Translation<\/h4>\n\n
\n
Developers<\/h4>\n\n
Automatic Installation<\/h4>\n\n
\n
Getting Started<\/h4>\n\n
\n
[dg]<\/code> to any post, page, or text widget. See Document Gallery Options below for configuration.<\/p>\n\nManual Installation<\/h4>\n\n
\n
document-gallery<\/code> folder to \/wp-content\/plugins\/<\/code><\/li>\nDocument Gallery Options<\/h4>\n\n
[dg]<\/code>.<\/p>\n\n[dg [fancy=<true\/false>] [attachment_pg=<true\/false>] [descriptions=<true\/false>] [order=<ASC\/DESC>] [orderby=<**see below**>]]\n<\/code><\/pre>\n\nSettings -> Document Gallery<\/code>.<\/p>\n\nattachment_pg=false<\/code>\n(the default). If you have information on the attachment page that you want the\nlink to go to, use attachment_pg=true<\/code>.<\/p>\n\ncategories<\/code> option you are able to select attachments based on\ntheir assigned category or any other\ncustom taxon<\/a>. Categories\nor any custom taxon can be referenced simply by including category=category_value<\/code>\nor taxon_name=taxon_value<\/code>. Multiple values for a single taxon may be separated\nby commas. Note that if a taxon value contains spaces then the entire comma-\ndelimited list must be quoted.<\/p>\n\ncolumns=-1<\/code>, you will get an infinite number of\ncolumns. In other words, only 1 row with all icons.<\/p>\n\ntrue<\/code>, each document will take its own line with the description displayed\nalongside it.<\/p>\n\ndescription<\/code> field, not<\/strong> the caption<\/code>. Be\ncareful when entering your document data.<\/em><\/p>\n\ntrue<\/code>, we will try to generate a thumbnail for each document in the gallery.\nThe success in generating thumbs will depend mostly on what your server supports.\nTo fine-tune how thumbnails are generated, visit Settings -> Document Gallery<\/code>\nin your site's dashboard.<\/p>\n\nid=-1<\/code> will match all attachments.<\/p>\n\nids<\/code> attribute (e.g.: ids=10,2,4,42<\/code>).<\/p>\n\nmime_types=application\/pdf<\/code>.<\/p>\n\norderby<\/code> option to determine whether the\ndocuments are displayed in ascending or descending order.<\/p>\n\n\n
menu_order<\/code> - This is probably the one you want to use. Menu order is\nthe order that icons appear when seen in the Insert \/ Upload Media Gallery\ndialog. To change this order, you simply drag the icons around until they\nare where you want them. In earlier versions of WordPress, menu_order was\nmodified by the integer fields in the Insert \/ Upload Media Gallery dialog.\nThese fields no longer exist in recent releases.<\/li>\ntitle<\/code> - Order by title.<\/li>\ndate<\/code> - Order by upload date.<\/li>\nmodified<\/code> - Order by last modified date.<\/li>\nrand<\/code> - Random order.<\/li>\nID<\/code> - Order by post id.<\/li>\nauthor<\/code> - Order by author.<\/li>\nname<\/code> - Order by attachment slug.<\/li>\nparent<\/code> - Order by post\/page parent id.\n(Only useful in conjunction with localpost=false<\/code> option.)<\/li>\ncomment_count<\/code> - Order by number of comments (available with WP >= 2.9).<\/li>\nnone<\/code> - No order (available with Version 2.8).<\/li>\npost__in<\/code> - Preserve post ID order given in the post__in array.<\/li>\n<\/ul>\n\n[dg category=x,y,z relation=AND]<\/code> will return any attachments where the\ncategory is x, y, OR z). If you wish to return only attachments with all 3 categories,\nyou will instead need to use the following syntax: [dg category=x,y,z category_relation=AND]<\/code>.\nThis syntax of *taxon<\/em>_relation will work for any taxon, not just \"category.\"*<\/p>\n\nCustomize Appearance<\/h4>\n\n
Settings -> Document Gallery<\/code> and put any custom CSS in the\nprovided text box.<\/p>\n\n