Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 112 lines (65 sloc) 5.265 kb
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
1 === Grid Columns ===
740b6be @justintadlock Readme updates.
authored
2
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
3 Contributors: greenshady
740b6be @justintadlock Readme updates.
authored
4 Donate link: http://themehybrid.com/donate
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
5 Tags: shortcode
6 Requires at least: 3.4
740b6be @justintadlock Readme updates.
authored
7 Tested up to: 3.7
f84641a @justintadlock Add license info to readme.txt.
authored
8 License: GPLv2 or later
740b6be @justintadlock Readme updates.
authored
9 Stable tag: 0.2.0
6bd5eca @justintadlock More code than I'd like. Not as pretty as I'd like. But, we've got a som...
authored
10
740b6be @justintadlock Readme updates.
authored
11 A [column] shortcode for creating columnized content.
6bd5eca @justintadlock More code than I'd like. Not as pretty as I'd like. But, we've got a som...
authored
12
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
13 == Description ==
6bd5eca @justintadlock More code than I'd like. Not as pretty as I'd like. But, we've got a som...
authored
14
740b6be @justintadlock Readme updates.
authored
15 This plugin has one function and one function only — to make columns. You use it by inputting content between `[column]` and `[/column]` within your post content editor (or anywhere shortcodes are allowed).
16
17 Grid Columns was created to fix the problem in which many theme developers were adding 20+ column shortcodes to their themes for something that should be extremely simple and done with only a single shortcode.
18
19 ### Professional Support
20
21 If you need professional plugin support from me, the plugin author, you can access the support forums at [Theme Hybrid](http://themehybrid.com/support), which is a professional WordPress help/support site where I handle support for all my plugins and themes for a community of 40,000+ users (and growing).
22
23 ### Plugin Development
24
25 If you're a theme author, plugin author, or just a code hobbyist, you can follow the development of this plugin on it's [GitHub repository](https://github.com/justintadlock/grid-columns).
ae5aba6 @justintadlock Readme update to remove the 10-columns example.
authored
26
740b6be @justintadlock Readme updates.
authored
27 ### Donations
6bd5eca @justintadlock More code than I'd like. Not as pretty as I'd like. But, we've got a som...
authored
28
740b6be @justintadlock Readme updates.
authored
29 Yes, I do accept donations. If you want to buy me a beer or whatever, you can do so from my [donations page](http://themehybrid.com/donate). I appreciate all donations, no matter the size. Further development of this plugin is not contingent on donations, but they are always a nice incentive.
6bd5eca @justintadlock More code than I'd like. Not as pretty as I'd like. But, we've got a som...
authored
30
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
31 == Installation ==
6bd5eca @justintadlock More code than I'd like. Not as pretty as I'd like. But, we've got a som...
authored
32
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
33 1. Uzip the `grid-columns.zip` folder.
740b6be @justintadlock Readme updates.
authored
34 2. Upload the `grid-columns` folder to your `/wp-content/plugins` directory.
35 3. In your WordPress dashboard, head over to the *Plugins* section.
36 4. Activate *Grid Columns*.
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
37
38 == Frequently Asked Questions ==
39
740b6be @justintadlock Readme updates.
authored
40 ### Why was this plugin created?
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
41
42 Many theme developers add several column shortcodes to their themes (note: this isn't allowed on WordPress.org). Essentially, the theme developers are doing a few things wrong:
43
44 * They lock users into using their themes forever.
45 * They create 20+ shortcodes for what is possible for one. This makes it look like their themes have more "features".
46 * They remove core WordPress filters that other plugins rely on.
47 * The code is just poorly developed altogether (most likely because they all copied from the same, bad source).
48
49 This plugin allows you to switch between any theme (no lock-in to your current theme). It was also developed with WordPress standards and usability in mind.
50
740b6be @justintadlock Readme updates.
authored
51 ### How do I use the [column] shortcode?
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
52
53 You can find more detailed instructions in the plugin's `docs/readme.html` file.
54
55 Everything is based on a grid. By default, this grid is "4". So, you can set up four columns like so:
56
740b6be @justintadlock Readme updates.
authored
57 [column grid="4" span="1"]Some content[/column]
58
59 [column grid="4" span="1"]Some content[/column]
60
61 [column grid="4" span="1"]Some content[/column]
62
63 [column grid="4" span="1"]Some content[/column]
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
64
740b6be @justintadlock Readme updates.
authored
65 You'll notice that each "span" is equal to the number of columns in the grid. So, if the span is "1", it's equal to one column. If the span is "2", it's equal to two columns. You can only have as many spans/columns as the grid allows. Therefore, `grid="4"` means you can only have four columns.
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
66
740b6be @justintadlock Readme updates.
authored
67 ### Can I get more detailed instructions?
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
68
740b6be @justintadlock Readme updates.
authored
69 If you need a more detailed guide, see `readme.html`, which is included with the plugin. It has a few examples and explains everything.
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
70
740b6be @justintadlock Readme updates.
authored
71 ### Help! My site's broken! What should I do?
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
72
740b6be @justintadlock Readme updates.
authored
73 Most likely, it's because you either have too many spans or not enough spans for your grid. Make sure each `span` argument for your `[column]` shortcode equals exactly the `grid` argument.
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
74
740b6be @justintadlock Readme updates.
authored
75 ### But, I did everything right.
76
77 If you're absolutely sure you're math is correct, it could be a conflict with your theme. It'd be impossible for me to know without seeing it in use on your site, so you'll either need to ask on my support forums or get your theme developer to help.
78
79 ### Can I have more than one set of grid columns in a post?
80
81 Yes. Absolutely. Just make sure each grid has the correct number of columns before starting a new one.
82
83 ### Can I nest columns?
84
85 No. This is a limitation of how WordPress handles shortcodes.
86
87 ### Can I use other shortcodes within the `[column]` shortcode?
88
89 Yes, you can. However, keep in mind, that I can't guarantee that your plugin developer knows what he's doing and created his shortcode correctly. But, yes, you can do this with properly-coded shortcodes.
90
91 ### Can I put content between two different column shortcodes?
92
93 It's possible, but you'll probably break something. I recommend against attempting this.
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
94
95 == Changelog ==
96
740b6be @justintadlock Readme updates.
authored
97 ### Version 0.2.0
98
99 * Added CSS style rules to override some issues with WordPress' `wpautop()`, which sometimes adds empty `<p>` and extra `<br />` tags.
100 * Added support for right-to-left languages.
5afcc49 @justintadlock Update changelog.
authored
101 * No more anonymous objects created by the plugin class.
102 * No need for `&` when adding an action/filter.
740b6be @justintadlock Readme updates.
authored
103
104 ### Version 0.1.1
95c3bb8 @justintadlock Don't forget to update the WordPress readme.txt.
authored
105
106 * Add more specific prefixes in the CSS.
107 * Add some better margin handling in case other CSS code is overwriting things willy-nilly.
108 * Add the `gc_column_content` filter hook and use it to apply formatting.
109
740b6be @justintadlock Readme updates.
authored
110 ### Version 0.1.0
b2785e6 @justintadlock Updated readme.txt to prepare for WordPress.org plugin repo.
authored
111
112 * Plugin released. Everything is new!
Something went wrong with that request. Please try again.