totaljs / framework

Node.js framework

Node.js framework

Total.js framework is a framework for Node.js platfrom written in pure JavaScript similar to PHP's Laravel or Python's Django or ASP.NET MVC. It can be used as web, desktop, service or IoT application.

IMPORTANT: New version Total.js 4

$ npm install -g total.js

• Total.js Code editor
• Total.js CMS
• Total.js Eshop
• Total.js Wiki
• Total.js Flow
• Total.js Flowboard
• Total.js Messenger
• Total.js Dashboard
• Total.js BlogEngine
• Total.js SuperAdmin
• Total.js HelpDesk
• Total.js OpenPlatform
• Total.js +100 examples
• NoSQL embedded database explorer
• Download +200 UI components for free
• Download +100 CMS widgets for free

---

• Website
• Get Started
• Documentation
• Wiki for Total.js products
• Live chat with professional support
• Total.js Blog
• Membership
• Changelog

Official support

• Support form
• Support e-mail: [email protected]

Top features
Offline documentation
Backward compatibility
HMVC architecture
Clean directory structure
Fully asynchronous
Full web server with serving of static files
Supports IP restrictions
Supports redirections
Supports reusable components
Supports just-in-time JS, CSS (variables and nesting) and HTML compressor
Supports just-in-time merging of static files (JavaScripts, CSS or HTML)
Supports just-in-time mapping of files
Supports media streaming (e.g. videos)
Supports modules and packages
Built-in image processing engine via ImageMagick or GraphicsMagick
Supports WebSockets (RFC 6455) and Server-Sent events
NEW Supports WebSockets client
Supports multipart/x-mixed-replace (IP camera streaming) uploading and sending
Supports RESTful routing
Supports middleware (like express.js) with custom options
Supports unit testing
Supports workers for heavy CPU operations
Supports 4x config files (common, debug, release and test)
Mailer with templating (Gmail, Outlook or classic SMTP servers with auth and TLS)
Built-in view engine (layouts, nested views, conditions, loops, inline helpers, etc.)
Localization with diff tool and CSV export
Supports cache mechanism
Supports schemas for creating business objects with validations, workflows, etc.
Supports injecting scripts, packages and views from URL
Supports String, Date, Number and Array prototypes
Supports additional utilities (e.g. create request, XML parsing, etc.)
Supports themes
Supports scripting
Possibility to rewrite existing functionality
NoSQL embedded database

Social networks

Please support the framework on social networks.

• Follow Total.js on Gitter
• Follow Total.js on GitHub
• Follow Total.js on Twitter - @totalframework
• Follow Total.js on Facebook
• Follow Total.js on LinkedIn

Contact

• (c) 2012-2021 by Peter Širka - [email protected]
• contact form https://www.totaljs.com/contact/
• [email protected]

framework's Issues

Websocket: Could not decode a text frame as UTF8

hi again;

these days I'm much discomfort. WebSocket server, the client sends the following message I get an error..

 client.send({adi:"şşşüüğğğ"}); 

I am getting the following error in the client side.

"Could not decode a text frame as UTF8"

can cause? and how can I solve?

thanks

Cannot find module 'partial.js'

I found another bug. When I start partial.js framework I got following error:

Any idea?

Is this supposed to work on IE?

I made a web chat using partialjs, but it does not work on IE browsers. My question is, using partial's websockets isn't it sopposed to work on all browsers?? I tried this examples and it doesn't work on IE neither.

html stream problem..

I tried to stream html like xml large example

function view_htmlstream() {
var self = this;

var index = 0;
var count = 0;
self.res.writeHead(200, { 'Content-Type': 'text/html' });   


self.res.write('partial.js<br>');
self.res.write('is<br>');
self.res.write('very<br>');
self.res.write('cool<br>');
self.res.end();

}

it works but got this error...

Error: Can't render headers after they are sent to the client. Error: Can't render headers after they are sent to the client.
at ServerResponse.OutgoingMessage._renderHeaders (http.js:734:11)
at ServerResponse.writeHead (http.js:1151:20)
at /home/arief/node_modules/partial.js/index.js:1686:9
at Gzip.onEnd (zlib.js:166:5)
at Gzip.EventEmitter.emit (events.js:117:20)
at _stream_readable.js:920:16

at process._tickCallback (node.js:415:13)

but if I set interval
var interval = setInterval(function() {
self.res.write('partial.js
');
},500);
var interval = setInterval(function() {
self.res.write('is
');
},500);
var interval = setInterval(function() {
self.res.write('very
');
},500);
var interval = setInterval(function() {
self.res.write('cool
');
},500);

I got same errors but the page show nothing..can you help??

Async router gets error "408 TIMEOUT"

I have a router with async task. While async tasks not copleted but the framework return response "408 TIMEOUT". Here is example code:

home: function () {
    var self = this;
    api.completeTask1(self.get.code, function(err, user) {
        if(err){
            //TODO: needs to display user friendly error
            self.view('login_with_facebook');
            return ;
        }

        api.completeTask2(self.global.dbo, user, self.global.dbo.ComeFromType.FACEBOOK, function(err, data) {
            if(err) {               
                self.view('login_with_facebook');
                return;
            }           
            self.redirect('/');
        });
    });
}

I tred to use "await" but it does not help the same result. Is there any why to do such tasks?

Request Payload vs. Form Data

I was used to jQuery in my apps and I was doing ajax request like this:

$('#btn-login').click(function() {
    $.ajax({
        type: 'post',
        url: '/login',
        data: {
            username: $('#username').val(),
            password: $('#password').val()
        },
        success: function(server) {
            alert('ok');
        },
        dataType: 'json'
    });
});

If I take a look on my ajax request in Chrome Developer Tools under Network tab, I see that username and password were sent like Form Data.

Lately I am testing angular.js and a similar ajax request I do with $http service:

$scope.login = function() {
    $http.post('/login', {
        username: $scope.username,
        password: $scope.password,
    }).success(function() {
        alert('ok');
    });
}

I noticed the difference how the data were sent. In this case with angular username and password were sent like Request Payload.

The question is how to get Request Payload data in partial.js? In the case with jQuery I simply do self.post.username and self.post.password. In the case with angular.js I am without any idea.

Should I need to return after self.json or self.plain or self.view?

My code is

function login(){
var self = this;
var username = self.post.username ? self.post.username : '';
if(username == ''){
    self.json({code: 1, info: self.resource('english', 'empty_username')});
            //should I return here?
    }
    ...
    // does server still run here if I don't return?
    ...
 }

Thanks

jQuery map file in public folder

I am talking about this file http://code.jquery.com/jquery-2.0.3.min.map. You can read more about this file on StackOverflow. The problem I have is that partial.js can not (do know know how to) server this file if I put it in the public folder.

Am I doing something wrong here or partial.js really fails this time?

how to run example?

I have low experience of node.js
How do I run example?

node index.js
give me
throw err;
^
Error: Cannot find module 'partial.js'

Wildcard subdomain routing?

Can partial.js organize wildcard subdomain routing?

Ror example send *.website.debug to subdomain() function in default controller?

Property 'view' of object #<Controller> is not a function

I have this piece of code which should return me view for single user editing after ajax requeest.

function htmlUserEdit() {
    var self = this;
    var model = {};
    var post = self.post;

    if(post.userID) {

        // model.ID = post.userID;

        self.database('users').one(function(doc) {

            //does user with 'userID' exist
            return doc.ID === post.userID;

        }, function(doc) {

            model = doc;

            self.view('settings/user-edit', model);
        });
    }
    else {
        var ID = "...";
        model.ID = ID;
    }

    self.view('settings/user-edit', model);
}

Instead of returning html code I get type error at line 19:

http://127.0.0.1:8004/
TypeError: Property 'view' of object #<Controller> is not a function TypeError: Property 'view' of object #<Controller> is not a function
    at /.../controllers/settings.js:42:9
    at cb (/.../node_modules/partial.js/nosql.js:360:3)
    at Object._onImmediate (/.../node_modules/partial.js/nosql.js:332:4)
    at processImmediate [as _immediateCallback] (timers.js:330:15)
--------------------------------------------------------------------

It is wierd beacuse I just copied and pasted the loading of view. Do you have any clue?

How to handle 404 POST request?

Using GET request, i can handle using
framework.route("#404", show404);

But can't handle POST request with:
framework.route("#404", show404, ["post"]);

TypeError: Object # has no method '_request_stats' TypeError: Object # has no method '_request_stats'
at Subscribe.urlencoded (/home/vagrant/subscribe/node_modules/partial.js/index.js:4128:8)
at EventEmitter.Framework._request (/home/vagrant/subscribe/node_modules/partial.js/index.js:2502:34)
at Server.EventEmitter.emit (events.js:98:17)
at HTTPParser.parser.onIncoming (http.js:2108:12)
at HTTPParser.parserOnHeadersComplete as onHeadersComplete
at Socket.socket.ondata (http.js:1966:22)
at TCP.onread (net.js:525:27)

url prefix

can i add a prefix before all route url?
ex:
route: framework.route('/shop/'.....
can access by /a/b/shop ,the prefix is /a/b

How to run the sample app (blog, chat) on IIS Node in the sub folder

Hi Peter,

I tried to download and test the blog example at the website partialjs.com. The project works perfectly on my local Node.js at http://localhost:8000/

However, when I copy the whole source code to my website to put in a sub folder, it does not work. For example, the sample link http://localhost/Node/blog/ returns error HTTP status 500. I don't know how to get your examples work on the sub folder of the website without a specified port number.

Thank you for your awesome framework!
Khoa

WebSocket 403 error on connection

Hi.
I have downloaded your example of instant chat from partial.js site. But when i try to start the connection with websocket , I recive "webSocket connection to 'ws://127.0.0.1:8005/' failed: Unexpected response code: 403". I'm using Chromium on Ubuntu machines.

Regards

Getting data from ctrl to view

I have simple function in controller which returns me view:

function htmlUserEdit() {
    var self = this;

    self.repository.text = 'Hi, I am repository text.';

    var model = {
        text: 'Hi, I am model text.'
    };

    self.view('settings/user-edit', model);
}

Actually this an editing form for users, nothing special.
I want to pass some data to view. As you can see I do it on two ways:

...
<div>@{repository.text}</div>
<div>@{model.text}</div>
...

Which is the right way or which way do you prefer? Is there any difference between them? Is there any other good option?

How to authentication using Redis for session store?

when use express, use the connect-redis..
how to using redis session for partial.js?

POST request does not work

The POST request does not accept in the router. Here is code(i use the latest version 1.2.7)

var HomeController = require('./home_controller').HomeController
    , ErrorController = require('./error_controller').ErrorController
    , AccountController = require('./account_controller').AccountController;


exports.install = function(framework) {

    /// error controller
    framework.route('/', HomeController.index);
    framework.route('#403', ErrorController.error403);
    framework.route('#404', ErrorController.error404);
    framework.route('#431', ErrorController.error431);
    framework.route('#500', ErrorController.error500);

    /// social login controller
    framework.route('/login', AccountController.login);
    framework.route('/login/facebook', AccountController.facebook);
    // the below router cannot accept POST request
    framework.route('/login/facebook/callback', AccountController.facebook_callback);    
};

Image Referencing

@{image} currently defines the full image script tag.

<\img src="/img/background/theimage" border="0" />

there are cases where the image tag would have to be referenced like

$("#demo").background(@{image})

which renders $("#demo").background( < \img src="" border="0" />);

how can I create a @{imagedirectory} which renders

$("#demo").background( @{imagedirectory} )

$("#demo").background("/img/background/theimage")

issue in url if ends with dots(...)

I have issue in the following URL:
http://localhost:3000/login/google/callback/?state=500340&code=4/s7eM5gjhv9VGtXrLe4-cIaG7nT19.wnJFkeEoSJcdsNf4jSVKMpYgdL4ofQI&authuser=0&prompt=consent&session_state=f85b5fcbef8b3a594d84c1821ebaee24559a407b..51e6

I have registered router as below:

framework.route('/login/google/callback', AccountController.google_callback);

in the result i got the following:
File not found (404).

clear cache event ?

hi;

Is there an event that is triggered when clearing cache?
because they keep the database object in the cache. while cleaning the cache necessary to disconnect the database object for that user.

thanks.

javascript issues

I got these error while using partial.js
Uncaught SyntaxError: Unexpected token var bootstrap.js:1
Uncaught SyntaxError: Unexpected token . app.js:1
Uncaught SyntaxError: Unexpected token ( bootstrap-datepicker.js:1

which not shown when I put in apache...how could it be..
how to debug it??

Condition in template can check easily?

Hello,

In my controller, I have

self.repository.menu = [
    {name: 'Home', url: '/'}, 
    {name: 'Login', url: '/user/login', flag: 'unlogged'},
    {name: 'Logout', url: '/user/logout', flag: 'logged'}
];
self.repository.flag = 'logged';

and template/menu.html

<ul class="right">
    <!--
        <li class="divider"></li>
        <li><a href="{url}">{name}</a></li>
    -->
</ul>

Is there a way to check condition in template file as ejs format?

<ul class="right">
<%
    for(var i in repository.menu) { 
         var menu = repository.menu[i];
         if(menu.flag == repository.flag) {
%>
    <li class="divider"></li>
    <li><a href="<%=menu.url%>"><%=menu.name %></a></li>
<% } } %>
</ul>

Thanks

Multi-lanuage routes

How to implement multi-lanuage routes?

I want to use the accept-language header to get the browser language, path url or cookie and then redirect automatically to the corresponding language route like:
site.com/en, site.com/cz/show/1, site.com/en/controller/action?page=1&sort=_date etc.

Any advice on this?
Thanks

self.content send status code

Hi;

i use a self.content function to jsonp response. How to send status code 500 ?

thanks.

Some changes for Heroku deployment

When I deploy eshop to Heroku, I have to change the framework code a bit to make it available. Because of Heroku do not provide enviroment IP so just let NodeJS decide which IP to use

In: eshop\node_modules\partial.js\index.js

Change near "self.ip = ip || '127.0.0.1';":

self.port = process.env.PORT || port || 8000;
self.ip = ip || '127.0.0.1';
if (process.env.PORT)
    self.server.listen(self.port);
else
    self.server.listen(self.port, self.ip);

@petersirka 👍 thank you for your great job 😄

How do definitions work?

I really do not understand definitions. Why and how should I use them? Do you have any good example?

Loading views with XHR

Hi, I need again a little help. :)

So I would like to make a menu with content in panel like this:

I am loading content with ajax. The problem is that when I click on 'product' the whole page is loaded again:

My controler "default.js":

exports.install = function(framework) {
    framework.route('/', landingPage);
    framework.route('/loadPanel', loadPanel, ['xhr']);
};

function landingPage() {
    var self = this;
    self.view('company');
}

function loadPanel() {
    var self = this;
    self.view(self.post.choice);
}

My default view "_layout.html":

<!DOCTYPE html>
<html>
<head>
    <title>My Site</title>
    <meta charset="utf-8" />
    <script src="//ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js"></script>
    <script type="text/javascript">
    function loadPanel(choice) {
        $.ajax({
            type: 'post',
            url: '/loadPanel',
            data: {
                choice: choice
            },
            success: function(server) {
                $('#panel').html(server);
                console.log(server);
            },
            dataType: 'html'
        });
    }
    </script>
</head>
<body>
    <div id="menu">
        <a onclick="loadPanel('company')" href="#">company</a> 
        <a onclick="loadPanel('product')" href="#">product</a> 
        <a onclick="loadPanel('contact')" href="#">contact</a> 
    </div>
    <hr />
    <div id="panel">@{body}</div>
</body>
</html>

And there are 3 views with dummy contant.

Question is how should I return this 3 views in controler? I would like to get only dummy content without "html" and "body" wrapper from _layout.html.

Not a directory '/usr/bin/partial.js'

Hi,
I want to start my project unsing partail.js (as you show on YouTube video http://www.youtube.com/watch?v=3GMQJki82Lo) but I have some initial problems.

marek@nassenfuss:~/Documents/node$ sudo npm -g install partial.js
[sudo] password for marek: 
npm http GET https://registry.npmjs.org/partial.js
npm http 304 https://registry.npmjs.org/partial.js
/usr/bin/partial.js -> /usr/lib/node_modules/partial.js/bin/partial
npm WARN package.json [email protected] No repository field.
npm WARN package.json [email protected] No repository field.
npm WARN package.json [email protected] No repository field.
[email protected] /usr/lib/node_modules/partial.js
marek@nassenfuss:~/Documents/node$ 
marek@nassenfuss:~/Documents/node$ partial.js

fs.js:654
  return binding.readdir(pathModule._makeLong(path));
                 ^
Error: ENOTDIR, not a directory '/usr/bin/partial.js'
    at Object.fs.readdirSync (fs.js:654:18)
    at Object.<anonymous> (/usr/lib/node_modules/partial.js/bin/partial:365:16)
    at Module._compile (module.js:456:26)
    at Object.Module._extensions..js (module.js:474:10)
    at Module.load (module.js:356:32)
    at Function.Module._load (module.js:312:12)
    at Function.Module.runMain (module.js:497:10)
    at startup (node.js:119:16)
    at node.js:901:3

Do you have any idea what causes this error?
My node version is v0.10.7.
I get the same error on Ubuntu 13.04 and Mac OS 10.8.3.

Using route flags "json" and "post" together

JSON request body: {"key1":"value1","key2":"value2"}
POST request body: key1=value1&key2=value2

Works as expected:

callback() {console.log(this.post)}
framework.route("/api", callback, {flags: ["json"], timeout: 10000});
framework.route("/api", callback, {flags: ["post"], timeout: 10000});

BUT:

callback() {console.log(this.post)}
framework.route("/api", callback, {flags: ["json", "post"], timeout: 10000});

got NULL when doing post request

Windows Script Host error

using windows 7:

$ npm install -g partial.js
$ mkdir myapp && cd myaap
$ partial.js

Any hints?

Custom templating engine

Looks like it is not possible now, but it would be great if there was a possibility use custom templating engine, for example, hogan.js.

Turkish documentation

hi.

I'm trying to prepare Turkish documentation. The first page contains installation and configuration.

github markdown: https://github.com/KiPSOFT/partial.js-turkish-doc

html version: http://www.kip-software.org/2013/08/partial-js-kurulum/

best regards.

Do partial.js support flush

Do partial.js supprot flush to send and how to combine with the layout?

the case study is

• I get request query for the head and navigation data
• instead of waiting the next query, I want to flush it then do the next query

Do you support it?

Angular.js example

Angular.js example https://github.com/petersirka/partial.js/tree/master/examples/angularjs does not work. Could you please fix it. I think that something is wrong with serving templates. It looks like partial.js wants to serve js/project.js with file_template function in templates.js.

reload controller js?

a restart required after controller code changed? or need some configuration?

onAuthorization callback

Hi;

I know the event is running all incoming calls OnAuthorization. How to redirect OnAuthorization event callback is false I want to do?

modules, Onroute event is the solution for my problem, right?

Thanks.

script type='text/template' in view.

In view:

<script type="text/template">
  <textarea>Text</textarea>  
</script>

minifyHTML() return:

<script type="text/template">
  [1385614705269]#0>
</script>

Possible solution:

diff --git a/internal.js b/internal.js
--- a/internal.js
+++ b/internal.js
@@ -2278,7 +2278,7 @@ function minifyHTML(html) {

        html = html.replace(reg1, '').replace(reg2, '');

-   Object.keys(cache).forEach(function(o) {
+   Object.keys(cache).reverse().forEach(function(o) {
                html = html.replace(o, cache[o]);
        });

Installation problem

Hi, I've some problem with testing the framwork. I just installed node.js, last version. I added globally the partial modules:

sudo npm install -g partial.js

then I put the examples in this folder and launch:

node /home/node/partial/examples/templating/index.js

If I launch it notify that can't find the partial.js module, so I edited enviroment NODE_PATH to include the right folder. All ok but now i got this error:

node.js:201
        throw e; // process.nextTick error, or 'error' event on first tick
              ^
TypeError: Object #<Object> has no method 'existsSync'
    at EventEmitter.configure (/usr/local/lib/node_modules/partial.js/lib/index.js:1920:10)
    at EventEmitter.init (/usr/local/lib/node_modules/partial.js/lib/index.js:1403:7)
    at EventEmitter.run (/usr/local/lib/node_modules/partial.js/lib/index.js:1646:14)
    at Object.<anonymous> (/home/node/partial/examples/templating/index.js:7:11)
    at Module._compile (module.js:441:26)
    at Object..js (module.js:459:10)
    at Module.load (module.js:348:32)
    at Function._load (module.js:308:12)
    at Array.0 (module.js:479:10)
    at EventEmitter._tickCallback (node.js:192:41)

I read that it could be because the lasts versions of nodejs has switch to "fs" instead of "path" so existsSync can't be find or somthing similiar, I'm not exprert. Could anyone confirm? It will be fix? Or I just did some error in installation?
Thank you!

Is possible use multiple layouts?

Hi,

Is possible use multiple layouts? or use another view engine?

websocket cannot work

i run below sample
http://www.partialjs.com/upload/chat.zip

and browser show bellow error

WebSocket is already in CLOSING or CLOSED state.
send
(anonymous function)
x.event.dispatch
y.handle

HTTP status codes 401

Does partial.js support custom HTTP status codes in response? Let's look this example. Every once in awhile I make a request to a server just for checking if user still has a session.

exports.install = function(framework) {
    framework.route('/auth/expiry', auth_expiry);
};

function auth_expiry() {
    var self = this;

    if ("user still has session") {
        self.json({ says: "okay", msg: "You still have session!" });
    }
    else {
        self.json({ says: "error", msg: "Your session has expired!" });
    }
}

Everything is okay, but could server response to me with status code 401 instead of 200?

websocket Connect Error: Error: socket hang up

hi again;

i'm testing websocket but have a problem.

my module code:

exports.install = function(framework) {
        framework.websocket("/", socket, ["json"]);
}

function socket(controller, framework) {    
    console.log("hi");
}

and my client code;

#!/usr/bin/env node
var WebSocketClient = require('websocket').client;

var client = new WebSocketClient();

client.on('connectFailed', function(error) {
     console.log('Connect Error: ' + error.toString());
});

client.connect('ws://127.0.0.1:3000/', "json");

i'm getting this error.
Warning: Native modules not compiled. XOR performance will be degraded.
Warning: Native modules not compiled. UTF-8 validation disabled.
Connect Error: Error: socket hang up

my system windows8 - x64

whats my problem ?

thanks.

How to disable css and javascript minifier?

Hi

When I'm debugging application I want to disable javascript/css minifier.
How can I do that?

Best regards,
Lukas

How to get model (or data) in controller and render in _layout.html

I have a problem when get model in _layout.html

In default.js, I have model like that

exports.install = function(framework) {
    framework.route('/', index);
};
function index(){
    var model = {menu: {url:'/product',name:'Product'}};
    self.view('index', model);
}

in index.html, I can get model.menu

<ul class="menu_index">
    <!-- I can see model.menu here -->
    <li><a href="{model.menu.url}">{model.menu.name}</a></li>
</ul>

but in _layout.htmt, I can't

<head></head>
<body>
    <ul class="menu_layout">
        <!-- But I can't see model.menu here -->
        <li><a href="{model.menu.url}">{model.menu.name}</a></li>
    </ul>
    <div>@{body}</div>
</body>

Any suggestion? Thanks

Routing with dot in the route

Is it possible to route an uri with dot in it? Something like this

exports.install = function(framework) {
    framework.route('/', index);
    framework.route('/products.json', products, ['+xhr']);
};

function index() {
    var self = this;
    self.view('app');
}

function products() {
    var self = this;
    self.json({...});
}

redirect all "logged" tagged path to login page

when access a "logged" tagged path,will got 404 Not Found,is there some way redirect to a login page?
thanks.

LESS

Hello,
I have troubles with LESS CSS.
I have example code

a {
  color: red;
  &:hover {
    color: green;
  }
}

and expected output is
a { color: red; } a:hover { color: green }

I've got this

a {
  color: red;
  &:hover {
    color: green;
  }
}

Documentation - Broken Link

Not sure where else to post this one, my apologies if I missed a link somewhere.. (:

The "options [Object]" link in the framework.route description is broken (http://docs.partialjs.com/Framework/#framework.route).

As far as I can see it should be pointing to http://docs.partialjs.com/HttpRouteOptions/

User authorization

I am looking authorization example and there is a thing in controller about flags which I do not understand.
https://github.com/petersirka/partial.js/blob/master/examples/authorization/controllers/default.js

If I am not logged in, I will be routed to the viewHomepage().
If I am logged in, I will be routed to the viewIsLogged();

I am wondering when does the framework check if I am logged in and how is this made? How does the framework use these custom flags "logged" and "unlogged". Is there a way to manually check if I am logged without flags?