Welcome!
SMSNinja is a high-effective firewall of FILTERing/BLOCKing SMS/MMS/iMessage/Call/FaceTime, it handles everything of telecommunication for you perfectly.
Thanks for your support! Have fun!

User's Guide
0 GENERAL
There're 3 lists in SMSNinja, including Privatelist, Whitelist and Blacklist. The priorities of them are Privatelist > Whitelist > Blacklist, meaning messages and calls will be FILTERED/BLOCKED in this way: If the caller/sender is in Privatelist, he's FILTERED by Privatelist; Otherwise he's checked by Whitelist, if he's in Whitelist, SMSNinja lets him go; Else SMSNinja sees whether he's in Blacklist to decide if he should be BLOCKED. All entries' priorities inside the 3 lists decrease from top to bottom, once a message or call matches one of the entries, the FILTERing/BLOCKing process stops right at that point. I'll use FILTER on Privatelist and BLOCK on Blacklist in the following text, please pay attention. Besides, all settings inside SMSNinja take effect when you quit SMSNinja. Read through this page before you ask a question online. If you're interested to help translate SMSNinja into your native language, please let me know and your name will be listed here :)

P.S. Play with SMSNinja for a while to get familiar with it, I've already tried my best to make everything simple and clear :P If you find this readme hard to understand, don't worry, you're supposed to know what I'm saying when you do meet the situation.

1 "SMSNinja" page
1.1
A complete SMSNinja shows 4 rows in this page, which are "SMSNinja", "Blocked Info", "Black & Whitelist" and "Private Zone". A fake SMSNinja shows 3 rows, without "Private Zone".

1.2
SMSNinja will be removed from multi-tasking bar automatically after it quits.

2 "Settings" page
2.1
If you fill in "Password", you will be asked to enter this password each time you launch SMSNinja.

2.2
Dial "Launch Code" in MobilePhone will launch SMSNinja. If you forget to set this and hide the icon, you can dial "666666" to launch SMSNinja.

2.3
You must respring manually after quitting SMSNinja to make the icon appear/disappear, if you set "Hide Icon".

2.4
If you turn on "Icon/Statusbar badge", a pair of numbers will be shown on icon/statusbar, representing "Unread Calls Counts, Unread Messages Counts" in "Blocked Info".

2.5
If you turn on "Clear blocked calls", BLOCKED call history will be deleted from MobilePhone's "Recents" view.

3 "Blocked Info" page
3.1
In "SMS" page, unread messages are colored blue, while others are colored black. There'll be a round button at the end of the row if that message contains images, tap the button to view them. An asterisk (*) will be added at the end of numbers that are BLOCKED by "Whitelist only", and the lower left pointed arrow on the right side of time stands for "incoming message". The same rules apply to "Call" page.

3.2
Please take note, all lists are loaded as you need, i.e. subsequent entries won't get loaded unless you scroll to view them. So when you're doing bulk operations, "All"/"None" only refers to the entries already loaded, and bulk operations may only apply to those loaded entries.

4 "Black & Whitelist" page
4.1
Asterisk (*) as wildcards are supported in Black/Whitelist numbers: "12345*" (without the quotation marks) for numbers with a prefix of "12345"; "*12345" for numbers with a suffix of "12345"; "*12345*" for numbers containing "12345", etc.

4.2
You can add several numbers/keywords at once, using double spaces (  ) as the separator. For example, "1  2  3" (without the quotation marks) turns to "1", "2", "3".

4.3
With a keyword "pear", messages containing "p*ear", "(pear]" and words like this will also be FILTERED/BLOCKED.

4.4
Long press a row in system call/message history to add BLOCK/FILTER numbers.

5 "Private Zone" page
5.1
If you fill in both "FakePW" and "Password" (in "Settings" page), a fake SMSNinja is presented when you enter "FakePW" at launch. And "Password" in "Settings" page is redirected to "FakePW" implicitly.

5.2
If you toggle on "Show Thunder", a thunder logo will be added to the statusbar when there's unread private info. Once you go the "Private Info" page, the thunder disappears.

5.3
If you toggle on "Show Semicolon", the badge of SMSNinja will use semicolon instead of comma, i.e. "6;6" not "6,6", when there's unread private info. Once you go the "Private Info" page, semicolon will be replace by comma again.

5.4
iOS 7 stock blocklist is taken over by SMSNinja, you can only remove existing rules from blocklist, and actually all rules there don't rule :)

6 "Private Info" page
6.1
In "SMS" page, the lower left/upper right pointed arrow on the right side of time stands for "incoming/outgoing SMS". Other rules are the same to "Blocked Info" page.

7. "Privatelist" page
7.1
Since the moment you add a person into Privatelist, all communication logs between you two will be deleted from stock applications and saved only in Private Zone. Other rules are the same to "Black & Whitelist" page.

8 Customization
8.1 The beeps of Black/Whitelist and Privatelist are located in "/var/mobile/Library/SMSNinja/blocked.caf" and "/var/mobile/Library/SMSNinja/private.caf". Replace them with other caf files (System caf files are under "/System/Library/Audio/UISounds/") and respring.

8.2
Data and setting files of SMSNinja are stored in "/var/mobile/Library/SMSNinja/". Make a backup of these files before reinstallation, put them back and then authorize read/write permissions to them using iFile or something alike afterwards.