This repository has been archived by the owner on Jan 10, 2023. It is now read-only.
/
readme.txt
148 lines (119 loc) · 6.62 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
=== Container Block ===
Contributors: mahdiyazdani, mypreview, gookaani
Tags: container, shape divider, gutenberg, wrapper, animation, video background
Donate link: https://www.mypreview.one
Requires at least: 5.2
Tested up to: 5.4.0
Requires PHP: 7.2
Stable tag: 1.2.0
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html
A Gutenberg editor block used for wrapping several blocks in a parent wrapper.
== Description ==
A fully customizable Gutenberg editor block used for wrapping several blocks in a parent wrapper, which enables you to do more sophisticated styling as well.
**Key Features**
* Maximum width
* Full-height
* Vertically align top.
* Vertically align center.
* Vertically align bottom.
* Scroll down icon — A scrolling mouse wheel animation that will offer direction to the user.
* Element ID — Smoothly scroll the window to a specific element or tag ID within the page.
* Color
* Visibility
* Desktop
* Laptop
* Tablet
* Smartphone
* Horizontal spacing
* Desktop
* Laptop
* Tablet
* Smartphone
* Alignment
* Desktop
* Laptop
* Tablet
* Smartphone
* Link to
* Page address or URL.
* Open in a new window.
* Border
* Width — Sets a width for the borders.
* Radius — Defines the radius of the corners.
* Color
* Shadow — Adds a box-shadow to the block.
* Shape — Multiple shapes to use as separators for sections or as the background graphic.
* Height — A few of the shapes such as “Simple” are adjustable.
* Color
* Animation on scroll
* Type — Allows you to animate elements as you scroll down, and up.
* Ease — Timing function to ease elements in different ways.
* Offset — Offset to trigger animation sooner or later in pixels.
* Delay — Delay the animation.
* Duration — Duration of animation.
* Run once — Whether animation should fire once, or every time you scroll up/down to the block.
* Background image
* Position — Sets the starting position of the background image; “Focal Point Picker” support.
* Repeat — Sets if and how the background image will be repeated.
* Size — Sets the size of the background image.
* Parallax — Not scrolling the background image with the page.
* Sliding background effect — Supports “Left to Right” and vice versa.
* Background video
* Background color
* Overlay opacity
* Align full and wide support
* Aria label — To define a string that labels the current block. You might use it in cases where the block content is not visible on the screen.
== Installation ==
= Minimum Requirements =
* PHP version 7.2 or greater.
* MySQL version 5.6 or greater or MariaDB version 10.0 or greater.
* WordPress version 5.0 or greater.
= Automatic installation =
Automatic installation is the easiest option — WordPress will handle the file transfer, and you won’t need to leave your web browser. To do an automatic install of the plugin, log in to your WordPress dashboard, navigate to the Plugins menu, and click “Add New.”
In the search field type “Container Block”, then click “Search Plugins.” Once you’ve found the plugin, you can view details about it such as the point release, rating, and description. Click “Install Now,” and WordPress will take it from there.
= Manual installation =
The manual installation method requires downloading the plugin and uploading it to your webserver via your favorite FTP application. The WordPress codex contains [instructions on how to do this here](https://wordpress.org/support/article/managing-plugins/#manual-plugin-installation "Manual plugin installation").
= Updating =
Automatic updates should work smoothly, but we still recommend you back up your site.
== Frequently Asked Questions ==
= How do I use the block? =
1. Log into your WordPress website and navigate to Dashboard.
2. Create a new page, by visiting “Pages” » “Add New”.
3. Click on the “Add Block” button and select the “Container” block. Alternatively, you can start typing `/container` in a new paragraph block, then press enter.
4. “Container Block” can contain other blocks. You can add content by clicking the `+` icon and picking a block.
5. Publish the page.
= Why should I use a container block in a page? =
The container div, and sometimes content div, are almost always used to allow for more sophisticated CSS styling. The body tag is special in some ways; However, browsers don't treat it like a normal div, and its position and dimensions are tied to the browser window.
= How do I get help with the plugin? =
The easiest way to receive support is to “Create a new topic” by visiting Community Forums page [here](https://wordpress.org/support/plugin/container-block "Container Block Support Forum").
Make sure to check the “Notify me of follow-up replies via email” checkbox to receive notifications, as soon as a reply posted to your question or inquiry.
*Please note that this is an opensource 100% volunteer project, and it’s not unusual to get reply days or even weeks later.*
= Can I help in translating this plugin into a new language? =
The plugin is fully translation-ready and localized using the GNU framework, and translators are welcome to contribute to the plugin.
Here’s the [WordPress translation website →](https://translate.wordpress.org/projects/wp-plugins/container-block "WordPress translation website")
= How do I contribute to this plugin? =
We welcome contributions in any form, and you can help reporting, testing, and detailing bugs.
Here’s the [GitHub development repository →](https://github.com/mypreview/container-block "GitHub development repository")
= Did you like the idea behind this plugin? =
Please share your experience by leaving this plugin [5 shining stars](https://wordpress.org/support/plugin/container-block/reviews/ "Rate Container Block 5 stars") if you like it, thanks!
= I need help customizing this plugin? =
I am a full-stack developer with over five years of experience in WordPress theme and plugin development and customization. I would love to have the opportunity to discuss your project with you.
[Hire me on UpWork →](https://www.upwork.com/o/profiles/users/_~016ad17ad3fc5cce94/ "Mahdi Yazdani Freelancer Profile")
== Screenshots ==
1. Add “Container” block
2. Scroll down icon
3. Border settings
4. Box-shadow settings
5. Blur shape (divider/graphic)
6. Blur shape (divider/graphic)
7. Sliding background effect
== Changelog ==
= 1.2.0 =
* Multiple code standards improvements.
* Compatibility with WordPress 5.4.0
= 1.1.0 =
* Code tidy.
* New range controls to have full control over the margins.
= 1.0.0 =
* Initial release.