WordPress.org
Get WordPress

Plugin Directory

Changeset 3467363


Ignore:
Timestamp:
02/23/2026 07:53:40 AM (6 weeks ago)
Author:
haroondev
Message:

change readme.txt file

File:
1 edited

Legend:

Unmodified
Added
Removed

  • postlane-posts-block/trunk/readme.txt

    r3467355 r3467363  
    11=== Postlane ===
    22Contributors: haroonjamil
    3 Tags: gutenberg, posts, grid, widget, blocks, drag-drop, layout
     3Tags: gutenberg-post, posts-grid, grid, block, widget
    44Requires at least: 5.8
    5 Tested up to: 6.9
     5Tested up to: 6.7
    66Stable tag: 1.0.0
    77Requires PHP: 7.4
    88License: GPLv2 or later
    9 License URI: http://www.gnu.org/licenses/gpl-2.0.html
     9License URI: https://www.gnu.org/licenses/gpl-2.0.html
    1010
    11 A customizable Gutenberg block for displaying posts with drag-and-drop ordering and grid/list layouts.
     11A Gutenberg block to display WordPress posts in grid or list layouts with drag-and-drop reordering and full customization controls.
    1212
    1313== Description ==
    1414
    15 **Postlane** lets you display your WordPress posts in beautiful grid or list layouts with complete customization control. Perfect for creating stunning blog layouts, portfolios, news sections, and more!
     15Postlane adds a powerful Gutenberg block that lets you display your WordPress posts anywhere on your site — in a clean list or a responsive grid. You control the layout, the content, and even the order of posts using a simple drag-and-drop interface right inside the editor.
    1616
    17 = ✨ Key Features =
     17Whether you're building a blog homepage, a news section, or a portfolio, Postlane gives you everything you need without writing a single line of code.
    1818
    19 * **📱 Dual Layout Modes**
    20   * Grid View (2, 3, or 4 columns)
    21   * List View (traditional blog style)
     19= Key Features =
    2220
    23 * **🔄 Drag & Drop Reordering**
    24   * Visual post reordering in editor
    25   * Custom order persists on frontend
    26   * Easy reset to default sorting
     21* **Grid and List Layouts** — Choose between list view or grid view with 2, 3, or 4 columns
     22* **Drag & Drop Reordering** — Reorder posts visually in the editor; custom order is saved and shown on the frontend
     23* **Category Filtering** — Show posts from a specific category or display all posts
     24* **Post Count Control** — Display anywhere from 1 to 20 posts
     25* **Sort Options** — Order posts by date, title, or randomly
     26* **Toggle Display Elements** — Show or hide featured images, titles, excerpts, dates, authors, and category labels
     27* **Excerpt Length Control** — Adjust excerpt word count between 5 and 100 words
     28* **Multiple Image Sizes** — Choose from thumbnail, medium, large, or full image sizes
     29* **Fully Responsive** — Layouts adapt automatically for desktop, tablet, and mobile
     30* **Lightweight** — No jQuery, no external dependencies, minimal resource usage
    2731
    28 * **🎯 Smart Filtering**
    29   * Filter by category
    30   * Adjustable post count (1-20)
    31   * Multiple sorting options (date, title, random)
     32= How It Works =
    3233
    33 * **🎨 Complete Customization**
    34   * Toggle featured images on/off
    35   * Show/hide post titles
    36   * Customizable excerpts (5-100 words)
    37   * Display/hide dates
    38   * Show/hide author names
    39   * Category badges
    40   * Enable/disable post links
    41   * Multiple image sizes
     34After activating the plugin, open any post or page in the block editor. Search for "Postlane" in the block inserter and add it to your content. Use the sidebar settings panel to configure the layout, filters, and display options. Optionally drag and drop posts in the editor preview to set a custom display order. Save and publish — your post feed is live.
    4235
    43 * **📱 Fully Responsive**
    44   * Mobile-friendly layouts
    45   * Automatic column adjustment
    46   * Touch-friendly drag & drop
     36= Privacy =
    4737
    48 * **⚡ Performance Optimized**
    49   * Lightweight code
    50   * No jQuery dependencies
    51   * Minimal HTTP requests
    52   * Fast loading times
    53 
    54 = 🎯 Perfect For =
    55 
    56 * Blog homepages
    57 * Portfolio showcases
    58 * News sections
    59 * Magazine-style layouts
    60 * Product displays
    61 * Category archives
    62 * Featured content areas
    63 
    64 = 🚀 Easy to Use =
    65 
    66 1. Add the block to any post or page
    67 2. Choose layout style (Grid or List)
    68 3. Select category or show all posts
    69 4. Set number of posts to display
    70 5. Toggle display options
    71 6. Drag and drop to reorder (optional)
    72 7. Publish!
    73 
    74 **No coding skills required!**
    75 
    76 = 🎓 Documentation =
    77 
    78 For detailed documentation and tutorials, visit the [WordPress.org support forum](https://wordpress.org/support/plugin/postlane-posts-block/).
    79 
    80 = 💬 Support =
    81 
    82 Need help? Have a feature request?
    83 * Visit our [Support Forum](https://wordpress.org/support/plugin/postlane-posts-block/)
    84 * Check our [FAQ Section](#faq)
    85 
    86 = 🌟 Like This Plugin? =
    87 
    88 * Rate it 5 stars ⭐⭐⭐⭐⭐
    89 * Share with friends and colleagues
    90 * Follow us for updates
     38Postlane does not collect any personal data, does not set cookies, and makes no external HTTP requests. It is fully compliant with GDPR and similar privacy regulations.
    9139
    9240== Installation ==
    9341
    94 = Automatic Installation (Recommended) =
     42= Automatic Installation =
    9543
    96 1. Log into your WordPress admin panel
    97 2. Go to **Plugins** → **Add New**
    98 3. Search for **"Postlane"**
    99 4. Click **"Install Now"** button
    100 5. Click **"Activate"** button
    101 6. Start using the block in Gutenberg editor!
     441. Log in to your WordPress admin dashboard
     452. Go to **Plugins > Add New**
     463. Search for **Postlane**
     474. Click **Install Now**, then click **Activate**
     485. Open any post or page in the block editor and search for the **Postlane** block
    10249
    10350= Manual Installation =
    10451
    105521. Download the plugin ZIP file
    106 2. Log into WordPress admin panel
    107 3. Go to **Plugins** → **Add New** → **Upload Plugin**
    108 4. Choose the downloaded ZIP file
    109 5. Click **"Install Now"**
    110 6. Activate the plugin
    111 7. Ready to use!
     532. Go to **Plugins > Add New > Upload Plugin** in your WordPress dashboard
     543. Upload the ZIP file and click **Install Now**
     554. Click **Activate Plugin**
    11256
    113 = Installation from Source (For Developers) =
     57= Requirements =
    11458
    115 1. Clone or download the plugin from repository
    116 2. Navigate to plugin directory in terminal
    117 3. Run `npm install` to install dependencies
    118 4. Run `npm run build` to compile assets
    119 5. Upload entire folder to `/wp-content/plugins/` directory
    120 6. Activate through WordPress admin panel
    121 
    122 = First Time Setup =
    123 
    124 After activation:
    125 1. Create a new post or page
    126 2. Click the **+** button to add a block
    127 3. Search for **"Postlane"**
    128 4. Insert the block
    129 5. Configure settings in the sidebar
    130 6. Customize to your liking!
     59* WordPress 5.8 or higher
     60* PHP 7.4 or higher
     61* A theme that supports the block editor (Gutenberg)
    13162
    13263== Frequently Asked Questions ==
    13364
    134 = Is this plugin completely free? =
     65= Does this plugin work with my theme? =
    13566
    136 Yes! This plugin is 100% free with no premium version, upsells, or hidden costs.
     67Yes. Postlane works with any WordPress theme that supports the block editor (WordPress 5.0 and above).
    13768
    138 = Does it work with my theme? =
     69= Can I display posts from a specific category? =
    13970
    140 Yes! The plugin works with any WordPress theme that supports the Gutenberg block editor (WordPress 5.0+).
     71Yes. Use the Category dropdown in the block settings panel to filter posts by any category on your site.
    14172
    142 = Can I customize the styling? =
     73= Can I show multiple Postlane blocks on one page? =
    14374
    144 Absolutely! You can:
    145 * Use built-in display options
    146 * Override CSS classes in your theme
    147 * Add custom CSS through WordPress Customizer
    148 * Modify styles via child theme
     75Yes. You can add as many Postlane blocks as you need on a single page, each with its own settings.
     76
     77= Can I manually set the order of posts? =
     78
     79Yes. Drag and drop the posts in the editor preview to reorder them. The custom order will be reflected on the frontend. Click "Reset Custom Order" in the block settings to revert to default sorting.
     80
     81= Can I control how long the excerpt is? =
     82
     83Yes. Use the Excerpt Length slider in the Display Settings panel to set a word count between 5 and 100 words.
    14984
    15085= Does it support custom post types? =
    15186
    152 Currently, the plugin supports standard WordPress posts. Custom post type support is planned for a future release.
     87Currently Postlane supports standard WordPress posts. Support for custom post types is planned for a future release.
    15388
    154 = Can I use multiple blocks on one page? =
     89= Is the plugin translation ready? =
    15590
    156 Yes! You can add as many Postlane blocks as needed, each with different settings.
     91Yes. Postlane is fully internationalized and ready to be translated into any language using standard WordPress translation tools.
    15792
    158 = Will this slow down my website? =
     93= Where do I report a bug or request a feature? =
    15994
    160 No! The plugin is built with performance in mind:
    161 * Lightweight code
    162 * Optimized queries
    163 * Minimal resources
    164 * No external dependencies
    165 
    166 = Is it mobile responsive? =
    167 
    168 Yes! The plugin is fully responsive and works beautifully on:
    169 * Desktop computers
    170 * Tablets
    171 * Mobile phones
    172 * All screen sizes
    173 
    174 = Can I reorder posts manually? =
    175 
    176 Yes! Simply drag and drop posts in the editor preview. The custom order will be saved and displayed on the frontend.
    177 
    178 = How do I reset the custom post order? =
    179 
    180 Click the **"Reset Custom Order"** button in the block settings to return to default sorting.
    181 
    182 = Can I show posts from specific categories only? =
    183 
    184 Yes! Use the category selector in the block settings to filter posts by category.
    185 
    186 = What happens if there are no posts? =
    187 
    188 The block will display a "No posts found" message. Make sure you have published posts in your selected category.
    189 
    190 = Can I control the excerpt length? =
    191 
    192 Yes! Adjust the excerpt length slider (5-100 words) in the Display Settings panel.
    193 
    194 = Does it work with page builders? =
    195 
    196 The block is designed for the Gutenberg editor. Compatibility with page builders may vary.
    197 
    198 = Is it translation ready? =
    199 
    200 Yes! The plugin is internationalization (i18n) ready and can be translated into any language.
    201 
    202 = How do I report a bug? =
    203 
    204 Please report bugs in the [WordPress.org support forum](https://wordpress.org/support/plugin/postlane-posts-block/).
    205 
    206 = Can I contribute to the plugin? =
    207 
    208 Yes! We welcome contributions. Post in the [support forum](https://wordpress.org/support/plugin/postlane-posts-block/) to suggest features or report issues.
    209 
    210 = Where can I request a feature? =
    211 
    212 Submit feature requests in the support forum. We review all requests for future updates.
     95Please use the [WordPress.org support forum](https://wordpress.org/support/plugin/postlane-posts-block/) to report bugs or submit feature requests.
    21396
    21497== Screenshots ==
    21598
    216 1. **Block Settings Panel** - Complete control over display options
    217 2. **Grid Layout - 3 Columns** - Beautiful grid layout with featured images
    218 3. **List Layout** - Traditional blog-style post listing
    219 4. **Drag & Drop Reordering** - Visual post reordering interface
    220 5. **Category Filtering** - Easy category selection
    221 6. **Mobile Responsive** - Perfect display on all devices
     991. Block settings panel showing layout and display options
     1002. Grid layout with 3 columns and featured images
     1013. List layout with excerpt, date, and author
     1024. Drag-and-drop post reordering in the editor
     1035. Category filtering and post count controls
     1046. Responsive display on a mobile screen
    222105
    223106== Changelog ==
    224107
    225 = 1.0.0 - 2024-02-10 =
    226 **Initial Release** 🎉
    227 
    228 * Grid layout support (2, 3, 4 columns)
    229 * List layout support
     108= 1.0.0 =
     109* Initial release
     110* Grid layout with 2, 3, and 4 column options
     111* List layout
    230112* Drag and drop post reordering
    231113* Category filtering
    232 * Customizable display options
    233 * Show/hide featured images
     114* Post count control (1–20 posts)
     115* Sort by date, title, or random
     116* Toggle featured images, titles, excerpts, dates, authors, and category labels
    234117* Adjustable excerpt length
    235 * Date and author display
    236 * Category badges
    237 * Link toggle option
    238118* Multiple image size options
    239119* Fully responsive design
    240 * REST API integration
    241 * Performance optimized
     120* REST API integration for editor preview
     121* No jQuery dependency
    242122
    243123== Upgrade Notice ==
    244124
    245125= 1.0.0 =
    246 Initial release of Postlane. Install and enjoy beautiful post layouts!
    247 
    248 == Additional Information ==
    249 
    250 = Browser Compatibility =
    251 
    252 * Chrome (latest)
    253 * Firefox (latest)
    254 * Safari (latest)
    255 * Edge (latest)
    256 * Opera (latest)
    257 
    258 = Minimum Requirements =
    259 
    260 * WordPress 5.8 or higher
    261 * PHP 7.4 or higher
    262 * MySQL 5.6 or higher
    263 
    264 = Recommended Requirements =
    265 
    266 * WordPress 6.0 or higher
    267 * PHP 8.0 or higher
    268 * MySQL 5.7 or higher
    269 
    270 = Development =
    271 
    272 * This plugin is actively maintained
    273 * Regular updates and improvements
    274 * Community-driven development
    275 * Open to contributions
    276 
    277 = Support & Feedback =
    278 
    279 We value your feedback! Please:
    280 * Rate the plugin
    281 * Leave a review
    282 * Report bugs
    283 * Suggest features
    284 * Ask questions in the forum
    285 
    286 = Privacy =
    287 
    288 This plugin:
    289 * Does not collect any user data
    290 * Does not use cookies
    291 * Does not make external API calls
    292 * Does not track users
    293 * Respects user privacy
    294 
    295 = Credits =
    296 
    297 * Developed by **Haroon Jamil**
    298 * Built with ❤️ for the WordPress community
    299 * Special thanks to Gutenberg development team
    300 * Icons and inspiration from the WordPress ecosystem
    301 
    302 = Links =
    303 
    304 * [Support Forum](https://wordpress.org/support/plugin/postlane-posts-block/)
    305 * [Rate & Review](https://wordpress.org/support/plugin/postlane-posts-block/reviews/)
    306 
    307 == Code Contribution ==
    308 
    309 Want to contribute or report issues? Post in the [support forum](https://wordpress.org/support/plugin/postlane-posts-block/) and we'll be happy to collaborate.
    310 
    311 == Donate ==
    312 
    313 If you find this plugin helpful, consider:
    314 * ⭐ Rating it 5 stars
    315 * ☕ Buying us a coffee
    316 * 🚀 Sharing with others
    317 * 💬 Providing feedback
    318 
    319 Your support helps us continue development!
     126Initial release of Postlane.
Note: See TracChangeset for help on using the changeset viewer.