Monthly Calendar View

[KirAsh4]

I reverted to much simpler times. One of the things that irked me is that I’m displaying a month/year on the calendar when it’s displayed right above it in the clock module. So, I made it optional. One can choose to turn off the header or leave it on. For those of you who don’t display the clock (or who put it elsewhere), it’s helpful to leave the header on, but if you have the clock enabled, there’s no sense in adding the month and year right below it again. This trims the header and keeps a clean interface.

And I left the ability for the end user to create a custom CSS file and modify the look (I turned the header back on for this preview):

In the above example, the custom CSS added a bullet point in between the month and year (which does not exist in the default CSS), made the year digits brighter, and colorized the current day. There are several nested elements that will allow the user to customize how they want their calendar to look. I’m looking at you guys who also have a colorized version of the weather module. :)

[flooo]

I really like that touch of green in there…
Well done!

[KirAsh4]

That’s the custom CSS being implemented. By default it doesn’t have any color nor border. The user can edit their CSS and personalize it that way. Essentially the code reads:

	// Module defaults
	defaults: {
		...
		displayMonthyear: true,
		cssStyle: "default" /* Current options are 'default', 'block', 'custom' */
	},

	// Required styles
	getStyles: function() {
		switch(this.config.cssStyle) {
			case "block":
				return ["styleDefault.css", "styleBlock.css"];
				break;
			case "custom":
				return ["styleDefault.css", "styleCustom.css"];
				break;
			default:
				return ["styleDefault.css"];
		}
	},

[KirAsh4]

So as it turns out, it’s extremely easy to let the calendar Do Its Own Thing as far as figuring out what day to start the week on, Sunday or Monday. It litereally done by the system’s LOCALE, which you control by setting a language option in the main 'config.js'. Below is a screen shot of the English ('en') versus Spanish ('es') setting:

Notice how the Spanish one starts on Monday (lunes) whereas the English one starts on Sunday. I am not manually calculating this to draw the calendar. Moment.js takes care of this automatically.

Here’s the drawback: if your LOCALE defines the start of the week as Sunday, but you want to VISUALLY set the calendar to Monday (or vice verse), that would require me to actually manually calculate the entire calendar and draw it out. It’s a pain in the rear to be honest.

[MichMich]

A bit late to the party thanks to a delightful holiday, but I must say: nice work on the calendar.
One small suggestion: change the green color to an inverted black and white digit. I prefer the MM to be fully B&W.

[KirAsh4]

@MichMich, it is, by default, B/W. Users can set a custom CSS to change the colors, like I did as a test.

[MichMich]

@KirAsh4 Nice work!

[KirAsh4]

I can spend days coming up with style ideas, but I think I’m done fiddling with this. It’s time to move on to the next step in the process. I’m cleaning up the branches on GitHub and getting ready to open the flood gates. In the mean time, here’s the 4 styles that I’m including. Note that the ‘slate’ style is really meant for people who have a mirror-less display as the colors probably won’t show very well through a 2-way mirror.

• The calendar is language aware, meaning it will translate to your language setting.
• The calendar will automatically start on either Monday or Sunday depending on your language setting.
• The header (month and year) can be suppressed (not shown) if desired.
• Customization can be done through the custom CSS file
• Current day is highlighted through CSS styling.
• Probably more stuff I forget at the moment … I’ll have it all written out in the README file, including the full styling tree.

[MichMich]

Could you try a version where the active day is black text on a white background? So a little white square with a black number in it? Preferably with rounded corners. (Radius 1 or 2).

[KirAsh4]

Oh I suppose …

Keep in mind that the styling can be changed by the user to whatever they want it to look like. The sky isn’t the limit … it’s their imagination. :)

[MichMich]

@KirAsh4 I understand. But I think this is the best default style … 😈

[KirAsh4]

It won’t be the “default” style, but the config will set it as 'default'. The reason is because the actual 'styleDefault.css' file needs to be clean and not have anything in it other than setting the proper margin, padding, and table/cell views for the calendar and it gets included always. Custom CSS files are pulled in on top of that. That way, the user doesn’t need to set any of that themselves, but rather just over ride what they want with their own styles. So I can have a 'styleMichMich' [*] that I can set as the default style to have today highlighted in a white box.

[*] actual name to be determined still …

Never mind, went a slightly different route …

[MichMich]

@KirAsh4 Don’t you just love it when you type loads of useless text online … LOL.

[KirAsh4]

I left it all for posterity. :)

[KirAsh4]

Ok all, for all intents and purposes, the current state of the monthly view calendar is done. While I do plan on incorporating more features in it, there’s really nothing that is preventing me from releasing it … except maybe a proper name for the module. And the reason I say that is because of the future plans I have. I could easily call it ‘monthlycalendar’, however when I roll in the weekly view as well, that makes the name not accurate anymore. So yeah … bit of a conundrum. Either I will split out the weekly one into a separate module all together, or I will end up naming this ‘that-calendar-thats-not-the-default-but-has-other-features-in-it’ … you get what I’m saying here.

Time to ponder some things I guess …

[jgom]

name it “AliceInCalendarLand.module”

I have solved the problem.

[KirAsh4]

Spent the day wrangling code. Apparently I have a lot of ‘sumptinks’ coming up! :)
This is just raw data processing. Stuff comes in, gets processed, and placed in the array which I then fetch. There’s no formatting in the code yet. Just don’t ask.

[Mitchfarino]

I really like that running week of events!!

Much better than the current calendar list

Great work!

[KirAsh4]

Thanks. It’s still in it’s very early stages. A lot can and will change still.

[KirAsh4]

And now that I’m home, on the vertical layout, I left the other calendarS turned on: