I am pleased to announce the latest version of the Datebocks Engine,
now called the “Datetime Toolbocks” plugin. The reason for the name
change is due to the very near future goal to master the world of time
input in addition to date entry.
To cut the email short for those that simply want to see and skip the
chit chat, visit:
And now for the details…
Here is a list of changes for v3.0.0
== 3.0.0
- Fully Object Orientated
- Changed the helper method name to “toolbocks_date_select” from
“datebocks_field” - Added options on helper method for Base and Calendar
- Added style for Help icon to show the pointer cursor
- Now able to use symbols on the helpers, such as
toolbocks_date_select(:model, :method) - Added ability to override input name for helper
- Added auto-detect and install for engines plugin
- Merged DHTML Calendar Engine helper methods (Needs more work)
- Enhanced debugging and error messages for invalid dates
- Now using a single object with parameters. No more ugly HTML elements.
- Able to have multiple datetime toolbocks elements on the same page
with custom attributes - Added option to disable the help icon & popup window
- Added “2 years from now”, “3 days ago”, “eleven years from today”
[Darrell T. [email protected]] - Added overloading on the months. If you enter in a number higher
than 12 for the month, it will assume you meant the day
= Datetime Toolbocks
Datetime Toolbocks is a very simple Ruby on Rails Engine which
provides a helper method to
instantly deploy the Datetime Toolbocks into your application.
The Datetime Toolbocks also includes JSCalendar as a subset of
functionality. It is in the long
term goal to enable this plugin to be able to be used as a whole, or
by accessing each part.
Whether that is the JSCalendar with a default text input box, advanced
Datetime Toolbocks
input without JSCalendar, or with both combined which is currently the
default.
This software package is developed using the Engines plugin. To find
out more about how to
use engines in general, go to http://svn.rails-engines.org for general
documentation about
the Engines mechanism.
To view a live demo of the Datetime Toolbocks, visit:
== Dependancies
This plugin currently only works with the latest version of the
Engines plugin located at:
http://svn.rails-engines.org/plugins/engines/
== Installation
- Create your Rails application, set up your databases, and install
the Engines plugin.
script/plugin install http://svn.rails-engines.org/plugins/engines/
- Install the Datetime Toolbocks
script/plugin install
http://svn.toolbocks.com/plugins/datetime_toolbocks/
-
Add the following within the “Rails::Initializer.run do |config|”
block in config/environment.rbconfig.plugins = [“engines”, “*”]
-
The Datetime Toolbocks provides a core stylesheets and in addition
to several javascript files, so you’ll
need to include these two lines within your application’s layout.
Add the following lines:
<%= stylesheet_link_tag “datetime_toolbocks”, “calendar-blue”,
:plugin => ‘datetime_toolbocks’ %>
<%= javascript_rel_tag “datetime_toolbocks”, “calendar”,
“lang/calendar-en”, “calendar-setup”, :plugin => ‘datetime_toolbocks’
%>
== Usage
For any model (ex Event) that has a :date column, to utilize Datetime
Toolbocks use toolbocks_date_select(‘event’, ‘start_date’) as a helper
within your view.
<%= toolbocks_date_select :model, :date_column, { :format => ‘us’,
:autoRollOver => false} %>
== Bugs
Please report any bugs or feature enhancements to
http://dev.toolbocks.com
–
Nathaniel Steven Henry Brown
Toll Free: 1-877-446-4647
Vancouver: 604-724-6624