Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

isite

Package Overview
Dependencies
Maintainers
1
Versions
359
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

isite

Create High Level Multi-Language Web Site [Fast and Easy]

  • 2024.6.4
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
41
decreased by-92.88%
Maintainers
1
Weekly downloads
 
Created
Source

isite now integrated with Social Browser https://social-browser.com so your site work on Social Browser by default

Create [ Node Js Web Site ] Supporting Many Development features

  • More Secure
  • Multi Language
  • Custom Apps [Modules]
  • Best Performance
  • Less Time
  • Less Cost
  • Fast Development

Features

  • Auto Routes [Simple & Advanced & Custom]
  • Auto Handle File Types Encoding [Fonts - Images - ...]
  • Merge Multi Files Contents in One Route
  • Auto Handle Request & Response Headers [Cookies - Parameters - params]
  • Auto Detect & Configer User Session
  • Built-in Security System [Users , Roles, Permissions]
  • Easy Creating Master Pages
  • Auto Caching All Routes & Management Site Files in Memory
  • Fast Read Files Content [Site Folder Structure]
  • [ Upload / Download ] Files
  • Custom Html Attributes [Server side Tags]
  • MongoDB Full Integration
  • Client libraries [jquery - bootstrap - font-awesome - angular]
  • Local Multi Charts Apps
  • Development Helper Functions
  • Site Dynamic Events Callback
  • Auto WebSocket Handle

Fast Startup

  • Download Startup Template
    git clone https://github.com/absunstar/isite-template
    cd isite-template
    npm i
    npm start

Installation

npm install isite

  • Works Stand-Alone or With Other Libs
  • updated every 1 month at least ( npm i isite ) for production apps

Using

  • Fast Startup Web Server.
var isite = require('isite');
var site = isite({ port: 8080 });

site.loadLocalApp('client-side');
site.loadLocalApp('security');

site.run();
  • Multi port opens
var isite = require('isite');
var site = isite();

site.loadLocalApp('client-side');
site.loadLocalApp('security');

site.run([8080, 5555, 9090, 12345]);
  • Default Options.
var isite = require('isite');
site = isite({
    port: process.env.port || 80,
    cwd: process.cwd(),
    dir: process.cwd() + '/site_files',
    upload_dir: process.cwd() + '/../uploads',
    download_dir: process.cwd() + '/../downloads',
    backup_dir: process.cwd() + '/../backup',
    apps: !0,
    apps_dir: process.cwd() + '/apps',
    name: 'Your Site',
    dynamic: false, // (auto set )dynamic db & prot based on folder name [ smart-Your Site-3000 ]
    savingTime: 60 // 60 minutes then save sessions and site data,
    log: !0,
    lang: 'ar',
    theme: 'default',
    help: !0,
    stdin: !0,
    https: {
        enabled: false,
        port: null,
        ports: [],
        key: null  // path or will use default,
        cert: null // path or will use default,
    },
    mongodb: {
        enabled: !0,
        host: 'localhost',
        port: '27017',
        userName: null,
        password: null,
        db: 'default_db',
        collection: 'default_collection',
        limit: 10,
        prefix: {
            db: '',
            collection: '',
        },
        identity: {
            enabled: !0,
            start: 1,
            step: 1,
        },
    },
    session: {
        timeout: 60 * 24 * 30,
        enabled: !0,
        storage: 'file' || 'mongodb',
        db: null,
        collection: 'users_sessions',
    },
    security: {
        enabled: !0,
        db: null,
        users_collection: 'users_info',
        roles_collection: 'users_roles',
        admin: {
            email: 'admin@isite',
            password: 'P@$$w0rd',
        },
        users: [],
    },
    cache: {
        enabled: !0,
        html: 0,
        txt: 60 * 24 * 30,
        js: 60 * 24 * 30,
        css: 60 * 24 * 30,
        fonts: 60 * 24 * 30,
        images: 60 * 24 * 30,
        json: 60 * 24 * 30,
        xml: 60 * 24 * 30,
    },
    proto: {
        object: !0,
    },
});

site.run();

Site Folder Structure

  • site stucture help you to manage you site easy and fast
- server.js - package.json - README.md -- apps -- site_files --- css - bootstrap.css - custom.css --- js - jquery.js - bootstrap.js - custom.js --- html - index.html --- fonts --- images - logo.png
--- json - items.json - words.json - roles.json - permissions.json --- xml - rss.xml
  • Create Folder Name "site_files"
  • inside it create these Sub folders [ html , css , js , json , fonts , images , xml , ... ]

Routes

  • Auto Convert All Routes URL & Parameters to Lower Case
  • Auto Manage Reponse Headers and Files Types
  • Support Multi Files in One Route
  • Save Route Response in Memory to Reuse for Fast Response
  • Auto Handle URL parametes
  • Auto Handle Body Parameters in not get header [post , put , delete , ...]
  • Auto Handle URL params [custom parameters from url structure]
  • Auto cache Files Content in memory
  • support compress to remove unwanted spaces and tabs and empty lines ...etc
  • support parser to handle custom html server side tags
  • Call Route From Other Route [ Server Side ]

Easy and Auto Site Routing

/* site.dir = process.cwd() +  "/site_files"
    You Can Change This Default Value when define isite
    or set site.dir = new path
*/

site.onGET({ name: ['/', '/home', '/index'], path: site.dir + '/html/index.html' });
site.onGET({ name: '/css/bootstrap.css', path: site.dir + '/css/bootstrap.min.css' });
site.onGET({ name: '/js/jquery.js', path: site.dir + '/js/jquery.js' });
site.onGET({ name: '/js/bootstrap.js', path: site.dir + '/js/bootstrap.js' });
site.onGET({ name: '/favicon.png', path: site.dir + '/images/logo.png' });
site.onPOST({ name: '/api', path: site.dir + '/json/employees.json' });

Merge Multi Files in one route

site.onGET({
    name: '/css/style.css',
    path: [site.dir + '/css/bootstrap.css', site.dir + '/css/custom.css'],
});
site.onGET({
    name: '/js/script.js',
    path: [site.dir + '/js/jquery.js', site.dir + '/js/bootstrap.js', site.dir + '/js/custom.js'],
});

Advanced Site Routing

site.onREQUEST('get', '/', (req, res) => {});

site.onREQUEST('get', { name: '/' }, (req, res) => {});

site.onGET('/home2', (req, res) => {
    site.callRoute('/home', req, res);
});

site.onGET({
    name: 'api/user/add',
    content: {
        done: true,
        id: 1,
    },
});

site.onGET('/', (req, res) => {
    site.readFile(site.dir + '/html/index.html', function (err, content, file) {
        res.set('Content-type', 'text/html');
        res.set('Content-size', file.stat.size);
        res.status(200).end(content);
    });
});

site.onGET('/', (req, res) => {
    site.html('index', function (err, content) {
        res.set('Content-type', 'text/html');
        res.status(200).end(content);
    });
});

site.onGET({
    // can use [get , post , put , delete , all]
    name: '/',
    path: site.dir + '/html/index.html', //Required
    parser: 'html', // default static [not paresed]
    compress: !0, // default false
    cache: false, // default !0
});

site.onGET({
    name: '/',
    callback: function (req, res) {
        res.set('Content-type', 'text/html');
        site.html('index', function (err, content) {
            res.status(200).end(content);
        });
    },
});

Auto Route All Files in Folder

site.onGET({ name: '/js', path: site.dir + '/js' });
site.onGET({ name: '/css', path: site.dir + '/css' });

Custom Route - Using * [any letters]

site.onGET('/post/*', function (req, res) {
    res.end('Any Route like /post/11212154545 ');
});
site.onGET('*', function (req, res) {
    res.end('Any Route Requested Not Handled Before This Code');
});

Request Parameters [GET , POST | PUT | Delete] Restful API

// read query parameter lower case
site.onGET('/api', function (req, res) {
    res.end('GET | name : ' + req.query.name);
});
// read query parameter default case as requested
site.onGET('/api', function (req, res) {
    res.end('GET | name : ' + req.queryRaw.name);
});

site.onPOST('/api', function (req, res) {
    res.end('POST | id : ' + req.body.id + ' , Name : ' + req.body.name);
});
site.onPUT('/api', function (req, res) {
    res.end('PUT | id : ' + req.body.id + ' , Name : ' + req.body.name);
});
site.onDELETE('/api', function (req, res) {
    res.end('Delete | id : ' + req.body.id);
});
site.onALL('/api', function (req, res) {
    res.end('Any Request Routing Type Not Handled Yet : ' + req.method);
});

Dynamic Parameters

// read params lower case
site.onGET('/post/:id/category/:cat_id', function (req, res) {
    res.end('GET | Id : ' + req.params.id + ', catId : ' + req.params.cat_id);
});
// read params default case as requested
site.onGET('/post/:id/category/:cat_id', function (req, res) {
    res.end('GET | Id : ' + req.paramsRaw.id + ', catId : ' + req.paramsRaw.cat_id);
});
//example : /post/AbCdEf/category/DDDDD

MVC Custom Route

site.onGET('/:controller/:Action/:Arg1', function (req, res) {
    res.end(
        'GET | Controller : ' +
            req.params.controller +
            ', Action : ' +
            req.params.Action /* Normal case*/ +
            ', action : ' +
            req.params.action /* lower case*/ +
            ', Arg 1 : ' +
            req.params.Arg1 /* Normal case*/ +
            ', arg 1 : ' +
            req.params.arg1 /* lower case*/,
    );
});
//example : /facebook/post/xxxxxxxxxx
  • To Easy Read File Contents From "site_files" Folder
site.html('index', function (err, content) {
    site.log(content);
});
site.css('bootstrap', function (err, content) {
    site.log(content);
});
site.js('jquery', function (err, content) {
    site.log(content);
});
site.json('items', function (err, content) {
    site.log(content);
});
site.xml('rss', function (err, content) {
    site.log(content);
});
  • Custom Read Files

    • Read From Local File in First Time and save in memory
    • next time Read Will be From Memory
//read file with custom header
site.onGET("/rss", function(req, res) {
    site.readFile(__dirname + "/site_files/xml/rss.xml", function(err, content , file) {
        res.set("content-type" , "text/xml")
        res.set("content-size" , file.stat.size)
        res.status(200).end(content) // or res.end(content)
    })
})
// or [ if file in site_files/xml folder]
site.onGET("/rss", function(req, res) {
    site.xml("rss", function(err, content , file) {
        res.set("content-type" , "text/xml")
        res.set("content-size" , file.stat.size)
        res.status(200).end(content)
    })
})

// Read and Merge multi files with custom header
site.onGET("/", function(req, res) {
    site.readFiles(
        [
            __dirname + "/site_files/html/head.html",
            __dirname + "/site_files/html/content.html",
            __dirname + "/site_files/html/footer.html"
        ],
        function(err, content) {
            res.writeHead(200, { "content-type": "text/html" });
            res.end(content);
        })
})

// Check if File Exits
site.isFileExists(path , (yes)=>{
    if(yes){
        // ...
    }
})
// or
let yes = site.isFileExistsSync(path)
if(yes){
    // ...
}

// Get File Info
site.fileStat(path , (err , stats)=>{
    console.log(stats)
})
// or
let stats = site.fileStatSync(path)

// Write Data to File
site.writeFile(path , data , err =>{

}
// Delete File
site.removeFile(path , err =>{

}) // or site.deleteFile


// Create New Dir
site.createDir(path , (err , path)=>{
    if(!err){
        // ...
    }
}) // or site.makeDir

WebSocket

  • Server Side
site.onWS('/chat', (client) => {
    client.onMessage = function (message) {
        console.log(message);
        if (message.type === 'connected') {
            client.send({ type: 'ready' });
        }
    };
    console.log('New Client ...' + client.ip);
});
  • Client Side
<script src="/x-js/all.js"></script>
site.ws('ws://localhost/chat', (server) => {
    window.server = server;
    server.onOpen = () => {
        server.send({ type: 'accessToken', content: '##session.accessToken##' });
    };
    server.onMessage = (msg) => {
        console.log(msg);
    };
});

// or

var ws = new WebSocket('ws://localhost/chat');

ws.onerror = function (error) {};
ws.onclose = function () {};

ws.onopen = function () {
    ws.send(JSON.stringify({ type: 'connect' }));
};

ws.onmessage = function (msg) {
    msg = JSON.parse(msg.data);
    if (msg.type === 'ready') {
        ws.send(JSON.stringify({ type: 'ready' }));
    }
};

Cookies

  • Cookie is Client Side Data Per User
  • Cookie is Enabled by Default
  • Support Multi Keys
site.onGET('/testSetCookie', function (req, res) {
    res.cookie('name', req.query.name);
    res.cookie('ip', req.ip);
    res.cookie('more', 'any data');
    res.end('cookie set');
}); //example : /testSetCookie?name=amr

site.onGET('/testGetCookie', function (req, res) {
    res.end('name from cookie : ' + req.cookie('name'));
}); //example : /testGetCookie

Sessions

  • Session is Server Side Data Per User
  • Every User has Unique Access Token
  • Session Management Automatic
  • Session Store in Database by Default
site.onGET('/testSetSession', function (req, res) {
    req.session.user_name = req.query.user_name;
    res.session.ip = req.ip;
    res.session.more =  'any data';
    site.saveSession(res.session);
    res.end('Session Set ok !! ');
}); //example : /testSetSession?user_name=absunstar

site.onGET('/testGetSession', function (req, res) {
    res.end('User Name from session : ' + req.session.user_name);
}); //example : /testGetSession

Custom App

  • Custom App Help you to Easy Management Site Life-Cycle
  • Easy Register & Integrated
  • Best Solution when work with Team

How to make it

  • Create your app folder in global apps folder
  • Add app.js file with this code
module.exports = function (site) {
    // write here your custom code
};
  • App Will Be Auto Register And Integerated With Your Site

add App From github

  • Add Apps from github to Your Site
   cd apps
   git clone https://github.com/absunstar/isite-client
   git clone https://github.com/absunstar/isite-security

add App From Local Path

site.importApp(FOLDER_PATH);

Master Pages

  • Master Page put content between header and footer
  • Master Page help you to not repate you code
  • Master Page make site layout look good with less code
  • Master Page has tow parts header and footer
site.addMasterPage({
    name: 'masterPage1',
    header: site.dir + '/html/header.html',
    footer: site.dir + '/html/footer.html',
});

site.addMasterPage({
    name: 'masterPage2',
    header: site.dir + '/html/header2.html',
    footer: site.dir + '/html/footer2.html',
});

site.onGET({
    name: '/ContactUs',
    masterPage: 'masterPage1',
    path: site.dir + '/html/contact.html',
    parser: 'html',
});

HTML Server Tags & Attributes

  • html server tags is html tags run in server side
  • html server tags make html structure easy management
  • html server tags is the next generation of html

Add Custom Html Content

site.onGET({ name: '/', path: site.dir + '/html/index.html', parser: 'html' });
<style x-import="page2.css"></style>
<div x-import="navbar.html"></div>
<div class="container">
    <h2>Page Heading 2</h2>
    <p x-import="info.html"></p>
</div>
<script x-import="custom.js"></script>
  • Pages "navbar.html" & "info.html" Must Be In HTML Site Folder ['/site_files/html/']
  • Style "page2.css" Must Be In HTML Site Folder ['/site_files/css/']
  • Script "custom.js" Must Be In HTML Site Folder ['/site_files/js/']

Dynamic Varibles Sets

site.var('siteName', 'First Site With Isite Library ');
site.var('siteBrand', 'XSite');
<title>##var.siteName##</title>
<h2>##var.siteBrand##</h2>
<h2>Lang : ##session.lang## , Theme : ##session.theme##</h2>
<h2>query name : ##query.name## , query age : ##query.age##</h2>
<h2>data name : ##data.name## , data age : ##data.age##</h2>
<h2>param category : ##params.category## , param post : ##params.post##</h2>

<div x-lang="ar">Show if Site Language is Arabic</div>
<div x-lang="en">Show if Site Language is English</div>
// auto detect user session language

<div x-permission="admin">Only Admi Users Can Show This Content</div>
<div x-permission="accounting">Only Accounting Users Can Show This Content</div>

<div x-feature="login">Only Login Users Can Show This Content</div>
<div x-feature="!login">Only Not Login Users Can Show This Content</div>
// auto detect user login status

<div x-features="os.mobile || os.android">Only Users From Mobile or Android Can Show This Content</div>
<div x-features="os.mobile && os.android">Only Users From Mobile and Android Can Show This Content</div>
// Using || , && to Multi Features

<div x-feature="os.mobile">Only Users From Mobile Can Show This Content</div>
<div x-feature="os.desktop">Only Users From Mobile Can Show This Content</div>

<div x-feature="os.windows">Only Users From Windows Can Show This Content</div>
<div x-feature="!os.windows">Only Users From Not Windows Can Show This Content</div>
<div x-feature="os.windowsxp">Only Users From Windows XP Can Show This Content</div>
<div x-feature="os.windows7">Only Users From Windows 7 Can Show This Content</div>
<div x-feature="os.windows8">Only Users From Windows 8 Can Show This Content</div>
<div x-feature="os.windows10">Only Users From Windows 10 Can Show This Content</div>

<div x-feature="os.linux">Only Users From Linux Systems Can Show This Content</div>
<div x-feature="os.mac">Only Users From Mac Systems Can Show This Content</div>
<div x-feature="os.android">Only Users From Android Systems Can Show This Content</div>
<div x-feature="os.unknown">Only Users From unknown Systems Can Show This Content</div>

<div x-feature="browser.edge">Only Users From Edge Browser Can Show This Content</div>
<div x-feature="browser.firefox">Only Users From FireFox Browser Can Show This Content</div>
<div x-feature="browser.chrome">Only Users From Chrome Browser Can Show This Content</div>
<div x-feature="browser.opera">Only Users From Opera Browser Can Show This Content</div>
<div x-feature="browser.unknown">Only Users From unknown Browser Can Show This Content</div>

<div x-feature="ip.xxx.xxx.xxx.xxx">Only Users From IP xxx.xxx.xxx.xxx Can Show This Content</div>

//auto detect user browser

MongoDB Integration

- Auto Add [ id ] as auto increment number [Like SQL]
- Handle [ _id ] Data Type
- Manage Closed Connections and Timeout
- Manage Multi Connections
- Manage Bulk [ Inserts & Updates & Deletes ]
- Global Database Events
- User Friendly Coding

// use connect collection [ Best Way For Security ]

$employees = site.connectCollection("employees")

// with database
$employees = site.connectCollection("employees" ,  "company")
//or
$employees = site.connectCollection({collection : "employees" , db : "company")


// insert one doc [ can use also [add , addOne , insert , insertOne]]
$employees.insertOne({name : 'amr' , salary : 50000} , (err , doc)=>{
    site.log(doc) // doc after inserted
})

// insert Many Docs [ can use also [ addMany , addAll , insertMany , insertAll]]
$employee.insertMany([{name : 'a'} , {name : 'b'}] , (err , docs)=>{
    site.log(docs , 'docs')
})

// select one doc [ can use also [ get , getOne , find , findOne , select , selectOne ]]
$employees.findOne({where:{id : 5} , select:{salary:1}} , (err , doc)=>{
    site.log(doc)
})
//or
$employees.findOne({ id : 5 } , (err , doc)=>{
    site.log(doc)
})


// select Multi docs [ can use also  [getAll , getMany , findAll , findMany , selectAll , selectMany ]]
$employees.findMany({
    where:{name : /a/i} ,
    select:{name: 1 , salary:1} ,
    limit : 50 ,
    skip : 10 ,
    sort:{salary : -1}
    } , (err , docs , count)=>{
        site.log(docs)
    }
)

// Update One Doc [ can use [ updateOne , update , editOne , edit]]
$employees.updateOne({
    where:{_id : 'df54fdt8h3n48ykd136vg'} ,
    set:{salary: 30000}} , (err , result)=>{
    site.log(result)
})
// or [ auto update by _id ]
$employees.updateOne({_id : 'df54fdt8h3n48ykd136vg' , salary : 5000} , (err , result)=>{
    site.log(result)
})

// Update Many Docs [ can use [ updateAll , updateMany , editAll , editMany]]
$employees.updateMany({
    where:{name : /a/i} ,
    set:{salary: 30000}} , (err , result)=>{
    site.log(result)
})

// Delete One Doc [ can use [ deleteOne , delete , removeOne , remove]]
$employees.deleteOne({where:{ _id : 'df54fdt8h3n48ykd136vg'}} , (err , result)=>{
    site.log(result)
})
// or [ auto delete by _id]
$employees.deleteOne('df54fdt8h3n48ykd136vg', (err , result)=>{
    site.log(result)
})
// or
$employees.deleteOne({name : /a/i} , (err , result)=>{
    site.log(result)
})

// Delete Many Docs [ can use [ deleteAll , deleteManye , removeAll , removeMany ]]
$employees.deleteMany({where:{name : /a/i}} , (err , result)=>{
    site.log(result)
})
// or
$employees.deleteMany({name : /a/i} , (err , result)=>{
    site.log(result)
})

// Import Object Data From Json File
$employees.import(FILE_PATH , (result)=>{

})

// Import Array Data From Json File
$employees.import(FILE_PATH , (result)=>{

})

// Export Object Data From Json File
$employees.export( OPTONS , FILE_PATH , (err , docs)=>{

})
// Export 10 employees that salary more than 1000
$employees.export({limit : 10 , where : {salary : {$gt : 1000}}} , FILE_PATH , (err , docs)=>{

})

// Remove duplicate data [ can use [deleteDuplicate , removeDuplicate]]
$employees.deleteDuplicate('name' , (err , result)=>{

})
// Remove Duplicate [ name and mobile ] Employee
$employees.deleteDuplicate({name : 1 , mobile : 1} , (err , result)=>{

})
// Remove Duplicate [ profile.name ] Employee
$employees.deleteDuplicate({'profile.name' : 1 } , (err , result)=>{

})

// Create Index Field
 $employees.createIndex({name : 1} , (err , result)=>{

 }

// Create Unique Field
 $employees.createUnique({name : 1} , (err , result)=>{

 }
 // Create Unique Fields
 $employees.createUnique({user_name : 1 , user_password : 1} , (err , result)=>{

 }

 // backup database
 site.backupDB() // backup current database to current backup folder
 site.backupDB({db:'' , path : ''})

 // restore database
 site.restoreDB() // restore current database from current backup folder
 site.restoreDB({db:'' , path : ''})

// API to download backup db
site.onGET('db', (req, res) => {
  site.backupDB(null, (err, options) => {
    if (!err) {
      res.download(options.path);
    } else {
      res.json(err);
    }
  });
});

//==================================================================
// Global Database Events
// from here you can catch all transactions

site.on('mongodb after insert' , (result)=>{

})
site.on('mongodb after insert many' , (result)=>{

})
site.on('mongodb after find' , (result)=>{

})
site.on('mongodb after find many' , (result)=>{

})
site.on('mongodb after update' , (result)=>{

})
site.on('mongodb after update many' , (result)=>{

})
site.on('mongodb after delete' , (result)=>{

})
site.on('mongodb after delete many' , (result)=>{

})


// ==================================================================
// Low Level Access Database Functions [ For Advanced Work ]

// Insert One Doc
   site.mongodb.insertOne({
            dbName: 'company',
            collectionName: 'employess',
            doc:{name:'amr',salary:35000}
        }, function (err, docInserted) {
            if (err) {
                site.log(err.message)
            } else {
                site.log(docInserted)
            }
        } , /* default waiting Sync or !0 for Async*/)

// Insert Many Docs
   site.mongodb.insertMany({
            dbName: 'company',
            collectionName: 'employess',
            docs:[
                    {name:'amr',salary:35000} ,
                    {name:'Gomana',salary:9000} ,
                    {name:'Maryem',salary:7000}
                ]
        }, function (err, result) {
            if (err) {
                site.log(err.message)
            } else {
                site.log(result)
            }
        }/* default waiting Sync or !0 for Async*/)

// Find One Doc
 site.mongodb.findOne({
            dbName: 'company',
            collectionName: 'employees',
            where:{},
            select : {}
        }, function (err, doc) {
            if (err) {
                site.log(err.message)
            } else {
                site.log(doc)
            }
        }/* default waiting Sync or !0 for Async*/)

// Find Many Docs
 site.mongodb.findMany({
            dbName: 'company',
            collectionName: 'employees',
            where:{},
            select : {}
        }, function (err, docs , count) {
            if (err) {
                site.log(err.message)
            } else {
                site.log(docs)
            }
        }/* default waiting Sync or !0 for Async*/)

//Update One Doc
           site.mongodb.updateOne({
            dbName: 'company',
            collectionName: 'employees',
            where:{salary:7000},
            set : {name:'New MARYEM'}
        }, function (err, result) {
            if (err) {
                site.log(err.message)
            } else {
                site.log(result)
            }
        }/* default waiting Sync or !0 for Async*/)

// Update Many Docs
           site.mongodb.updateMany({
            dbName: 'company',
            collectionName: 'employees',
            where:{salary:9000},
            set : {salary:9000 * .10}
        }, function (err, result) {
            if (err) {
                site.log(err.message)
            } else {
                site.log(result)
            }
        }/* default waiting Sync or !0 for Async*/)

// Delete One Doc
          site.mongodb.deleteOne({
            dbName: 'company',
            collectionName: 'employess',
            where:{_id: new site.mongodb.ObjectID('df54fdt8h3n48ykd136vg')}
        }, function (err, result) {
            if (err) {
                site.log(err.message)
            } else {
                site.log(result)
            }
        }/* default waiting Sync or !0 for Async*/)
// Delete Many Docs
          site.mongodb.deleteMany({
            dbName: 'company',
            collectionName: 'employess',
            where:{name : /a/}
        }, function (err, result) {
            if (err) {
                site.log(err.message)
            } else {
                site.log(result)
            }
        }/* default waiting Sync or !0 for Async*/)

// ==================================================================
// Mongodb Native Client Provider

site.mongodb.client // = require("mongodb").MongoClient

// Create a database called "mydb":

var url = "mongodb://localhost:27017/mydb";

site.mongodb.client.connect(url, function(err, db) {
  if (err) throw err;
  console.log("Database created!");
  db.close();
});

// all code can be found in offical mongodb site or w3schools

Upload File

  • upload File using HTML
<form action="uploadFile" method="post" enctype="multipart/form-data">
    <input type="file" name="fileToUpload" /><br />
    <input type="submit" />
</form>
  • Upload File Using Angular js
<form class="form">
    <label>Select File To Upload</label>
    <input type="file" name="fileToUpload" onchange="angular.element(this).scope().uploadFile(this.files)" />
    <p>{{uploadStatus}}</p>
</form>
$scope.uploadFile = function (files) {
    var fd = new FormData();
    fd.append('fileToUpload', files[0]);
    $http
        .post('/uploadFile', fd, {
            withCredentials: !0,
            headers: {
                'Content-Type': undefined,
            },
            uploadEventHandlers: {
                progress: function (e) {
                    $scope.uploadStatus = 'Uploading : ' + Math.round((e.loaded * 100) / e.total) + ' %';
                    if (e.loaded == e.total) {
                        $scope.uploadStatus = '100%';
                    }
                },
            },
            transformRequest: angular.identity,
        })
        .then(
            function (res) {
                if (res.data && res.data.done) {
                    $scope.uploadStatus = 'File Uploaded';
                }
            },
            function (error) {
                $scope.uploadStatus = error;
            },
        );
};
  • Recive Uploading File from [html , angular , jquery , ...]
site.onPOST('uploadFile', (req, res) => {
    var response = { done: !0 };
    var file = req.files.fileToUpload;
    var newpath = site.dir + '/../../uploads/' + file.originalFilename;
    site.mv(file.filepath, newpath, function (err) {
        if (err) {
            response.error = err;
            response.done = false;
        }
        res.end(JSON.stringify(response));
    });
});

Download File

  • download any file from server
  • auto handle file content and size
  • force client browser to download file
// download any file
site.onGET('/files/file1.zip', (req, res) => {
    res.download(site.dir + '/downloads/file1.zip');
});
//download and change file name
site.onGET('/files/file1.zip', (req, res) => {
    res.download(site.dir + '/downloads/file1.zip', 'info.zip');
});

Multi Languages

  • Can Add Any Custom Language You Want
  • Can Change Default Language on Site Options
  • Stores Words in Diffrent Language in words json file
  • Auto Detect Words.json
  • Folder Structure Like This
- apps - server.js - package.json - README.md -- site_files --- json - words.json
  • Words Json File Structure Like This
[
    { "name": "user_name", "en": "User Name", "ar": "أسم المستخدم" },
    { "name": "user_email", "en": "Email", "ar": "البريد الالكترونى" },
    { "name": "user_password", "en": "Password", "ar": "كلمة المرور" }
]
  • Use in html Like This
<form>
    <label> ##word.user_name## </label>
    <input />
    <br />

    <label> ##word.user_email## </label>
    <input />
    <br />

    <label> ##word.user_password## </label>
    <input />
    <br />
</form>
  • Cahnge Site Language
$scope.changeLang = function (lang) {
    $http({
        method: 'POST',
        url: '/x-language/change',
        data: { name: lang },
    }).then(function (response) {
        if (response.data.done) {
            window.location.reload(!0);
        }
    });
};
<a ng-click="changeLang('ar')"> Change To Arabic </a> <a ng-click="changeLang('en')"> Change To English </a>
  • Show Content Depended on Language
<div x-lang="ar">This Content Will Display When Site Language is Arabic</div>
<div x-lang="en">This Content Will Display When Site Language is English</div>

Client libraries

    cd apps
    git clone https://github.com/absunstar/isite-client
- no need to install any client library
- no need to install any fonts
- no need to manage library routes
- just use it
<link rel="stylesheet" href="/x-css/bootstrap3.css" />
<link rel="stylesheet" href="/x-css/font-awesome.css" />

<script src="/x-js/jquery.js"></script>
<script src="/x-js/bootstrap3.js"></script>
<script src="/x-js/angular.js"></script>

Charts

  • Server Side
site.loadLocalApp('charts');
  • Client Site
<div id="chart1"></div>
<script src="/js/charts.js"></script>
var data = [
    {
        item: 'item 1',
        count: 500,
    },
    {
        item: 'item 2',
        count: 200,
    },
    {
        item: 'item 3',
        count: 700,
    },
    {
        item: 'item 4',
        count: 300,
    },
    {
        item: 'item 5',
        count: 800,
    },
    {
        item: 'item 6',
        count: 60,
    },
];

site.create_chart({
    type: 'xy',
    x: 'item',
    y: 'count',
    data: data,
    selector: '#chart1',
});

Security

    cd apps
    git clone https://github.com/absunstar/isite-security
  • Manage users From This Route [ /security ]

Helper Functions

site.onGET('/', (req, res) => {
    res.render('index.html', { name: 'amr', age: '36' }, { compress: !0, cache: false, parser: 'html css js' });
    res.render('custom.css', { 'font-size': '18px' }, { parser: 'css' });
    res.render('custom.js', { 'allow-ads': !0 }, { parser: 'js' });
    res.code = 301; // set response code to 301
    res.status(301); // set response code if not set to 301 and return response object
    res.set('Content-Type', 'text/plain'); // add response header
    res.remove('Content-Type'); // remove response header
    res.delete('Content-Type'); // remove response header
    res.redirect('/URL' , 302); // Any URL
    res.send('HTML CONTENT'); // Any HTML Content or object
    res.send(obj); // Any HTML Content or object
    res.htmlContent('HTML CONTENT'); // Any HTML Content
    res.html('index'); // like res.render
    res.css('bootstrap'); // css file name
    res.js('jquery'); // js file name
    res.json('items'); // json file name or object
    res.json(obj); // json file name or object

    if (req.hasFeature('browser.chrome')) {
    }
    if (req.hasFeature('browser.firefox')) {
    }
    if (req.hasFeature('browser.edge')) {
    }
    if (req.hasFeature('browser.opera')) {
    }
    if (req.hasFeature('browser.ucbrowser')) {
    }
    if (req.hasFeature('browser.baidu')) {
    }
    if (req.hasFeature('browser.chromium')) {
    }
    if (req.hasFeature('browser.unknown')) {
    }

    if (req.hasFeature('os.windows')) {
    }
    if (req.hasFeature('os.linux')) {
    }
    if (req.hasFeature('os.mac')) {
    }
    if (req.hasFeature('os.android')) {
    }
    if (req.hasFeature('os.unknown')) {
    }

    req.ip; // user ip
    req.port; // user port
    req.ip2; // server ip
    req.port2; // server port
    req.features; // array of user info [os , browser]
});

var person = { name: 'amr', email: 'absunstar' };
var person2 = site.copy(person);
person2.name = 'Abd Allah';
site.log(person);
site.log(person2);

var hash = site.md5('this content will be hashed as md5');
var base64 = site.toBase64('this content will be encript as base64 string');
var normal = site.fromBase64(base64);
var jsonString = site.toJson(person);
var jsonObj = site.fromJson(jsonString);
site.log(hash);
site.log(base64);
site.log(normal);
site.log(jsonString);
site.log(jsonObj);

var name = 'absunstar';
if (name.like('*sun*')) {
    site.log('yes');
}

Events

  • Events Are Global Actions Across Site
site.on('event name', function (obj) {
    console.log('name : ' + obj.name);
});

site.on('event name 2', function (list) {
    console.log('name : ' + list[0].name);
    console.log('name : ' + list[1].name);
});

site.on('event name 3', function (obj, callback) {
    console.log('try long code : ' + obj.name);
    setTimeout(function () {
        callback();
    }, 3000);
});

site.on('sync event name 1', function (obj, callback, next) {
    console.log('name : ' + obj.name);
    next(); // to run next event
});
site.on('sync event name 2', function (obj, callback, next) {
    console.log('name : ' + obj.name);
    next(); // to run next event
});
site.call('event name', { name: 'x1' });
site.call('event name 2', [{ name: 'n1' }, { name: 'n2' }]);
site.call('event name 3', { name: 'some long code' }, () => {
    console.log('after excute some long code');
});

site.quee('sync event name 1', { name: 'x1' });
site.quee('sync event name 2', { name: 'x2' });

Must Update

  • You Must Update This Lib Every Month ( npm i isite )

Hints

  • This Framework Make Security and Safty in the First Place
  • This Framework From Developer to Developers
  • This Framework Free for Education and Supported For Ever
  • This Framework Upgraded Arround the Clock
  • This Framework Development by One Developer
  • For Producation Contract what's up (+966568118373)

Contact Me

Keywords

FAQs

Package last updated on 01 Jun 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc