[web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-02-02 Thread wwwgong
Massimo,
Do you plan to add a section to briefly highlight the major revisions when 
the new edition of web2py book comes online?
Thanks,
Wen

On Sunday, January 20, 2013 6:52:02 PM UTC-5, Massimo Di Pierro wrote:

 I am looking for help proofreading the final version of the book. It is 
 almost done up to a final touch. 

 The attached file contains the changes between the 4th edition and 5th 
 edition (only the new text). It would be great is some native english 
 speaker could be me proof-read the changes. If you can help please edit the 
 text in place with a text editor, without adding line breaks or extra 
 spaces so I can diff the corrections. 

 The first two people who volunteer to help and can proof-read the attached 
 file by Saturday, will receive a free copy of the printed book as soon as 
 it is done. 

 Massimo 




-- 

--- 
You received this message because you are subscribed to the Google Groups 
web2py-users group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to web2py+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.




[web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-01-28 Thread Dane Wright
A few minor typos -

Line 17178 under WingIDE, Rad2Py, and Eclipse - change 'execued' to 
'executed' 
from: 
+it does not change the logic as this is never execued but it forces the 
IDE to parse it and understand where the objects in the global namespace 
come from (the ``gluon`` module) thus making autocompletion work.
to:
+it does not change the logic as this is never executed but it forces the 
IDE to parse it and understand where the objects in the global namespace 
come from (the ``gluon`` module) thus making autocompletion work.

Line 17200 under Publishing a folder - change 'fiels' to 'files' 
from: 
+which you can render in a view with ``{{=fiels}}``. 
to:
+which you can render in a view with ``{{=files}}``.

I'm not sure whether text under Google Wallet is being updated in the new 
edition but the current 4.9 edition has a few missing or incorrect  words 
(proposed text shown below in CAPS) -

If you want a tighter integration, you have to use the Level 2 
notification API. In that case you can pass more information to Google and 
Google will call your API to notify about purchases. This allows you to 
keep accounting information within your application but it requires you TO 
expose web services that can talk to Google Wallet.

This is a considerable - CONSIDERABLY more difficult problem but such AN 
API has already been implemented and it is available as A plugin from .

and under Stripe.com:

Stripe also allows you TO verify a transaction at a later time:

Dane

-- 

--- 
You received this message because you are subscribed to the Google Groups 
web2py-users group.
To unsubscribe from this group, send email to 
web2py+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.




[web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-01-27 Thread Dane Wright
Some minor corrections -

Line 1724 - change 'browser' to 'browse' and add 'one' 
from: 
+Line 38 creates a ``grid`` object that allows to browser, add and update 
the comments linked to a page.
to:
+Line 38 creates a ``grid`` object that allows one to browse, add and 
update the comments linked to a page.

Line 12921 - add 'to'  
from:
+Attention: grid and smartgrid were experimental prior web2py version 2.0 
.
to:
+Attention: grid and smartgrid were experimental prior to web2py version 
2.0 .

Line 12924 - change 'browser' to 'browse'
from:
+These are two high level gadgets that create complex CRUD controls. They 
provide pagination, the ability to browser, search, sort, create, update 
and delete records from a single gadgets.
to:
+These are two high level gadgets that create complex CRUD controls. They 
provide pagination, the ability to browse, search, sort, create, update and 
delete records from a single gadgets.

Dane

On Sunday, 20 January 2013 23:52:02 UTC, Massimo Di Pierro wrote:

 I am looking for help proofreading the final version of the book. It is 
 almost done up to a final touch. 

 The attached file contains the changes between the 4th edition and 5th 
 edition (only the new text). It would be great is some native english 
 speaker could be me proof-read the changes. If you can help please edit the 
 text in place with a text editor, without adding line breaks or extra 
 spaces so I can diff the corrections. 

 The first two people who volunteer to help and can proof-read the attached 
 file by Saturday, will receive a free copy of the printed book as soon as 
 it is done. 

 Massimo 




-- 





Re: [web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-01-27 Thread Martin Weissenboeck
*Experiences with janrain*

I wanted to get janrain work and I have spent some hours to start this
service. Maybe the following lines could help:

(1) From the book:

You can register with Janrain.com, register a domain (the name of your app)
and set of URLs you will be using, and they will provide you with an API
key.

(2) There is a short description how to use janrain in the file db.py:

## if you need to use OpenID, Facebook, MySpace, Twitter, Linkedin, etc.
## register with janrain.com, write your domain:api_key in
private/janrain.key
#from gluon.contrib.login_methods.rpx_account import use_janrain
#use_janrain(auth, filename='private/janrain.key')

Both „domain:api_key“ and „private/janrain.key“ are wrong.

(3) The correct example is in the book:

Integration with OpenID, Facebook, etc.

You can use the web2py Role Base Access Control and authenticate with other
services like OpenID, Facebook, LinkedIn, Google, Dropbox, MySpace, Flickr,
etc. The easiest way is to use Janrain Engage (formerly RPX)
(Janrain.com)

Now edit the model of your web2py application and place the following lines
somewhere after the definition of the auth object :

from gluon.contrib.login_methods.rpx_account import RPXAccount
auth.settings.actions_disabled=['register','change_password','request_reset_password']
auth.settings.login_form = RPXAccount(request,
api_key='...',
domain='...',
url = http://localhost:8000/%s/default/user/login; %
request.application)

The first line imports the new login method, the second line disables local
registration, and the third line asks web2py to use the RPX login method.
You must insert your own api_key provided by Janrain.com, the domain you
choose upon registration and the external url of your login page.
*
*(4) Maybe the last lines should be changed to:

auth.settings.login_form = RPXAccount(request,
api_key='...',
domain='...',
url = http://your-external-address/%s/default/user/login; %
request.application)

The first line imports the new login method, the second line disables local
registration, and the third line asks web2py to use the RPX login method.

Login at janrain.com and go to Deployment  Application Settings. On the
right side there is the „Application Info“:
The api_key  is called „API Key (Secret)“.
The domain is the „Application Domain“ *without leading *„https://“
and *without
the trailing *„.rpxnow.com/“
For example: if you have registered a website like „secure.mywebsite.org“
Janrain has turned it to the Application Domain „
https://secure-mywebsite.rpxnow.com“. Please insert only „secure-mywebsite“
as domain.
The url is the external url of your login page.

(5) Proceed to Deplayment  Application settings  Domain Whitelist
Enter „your-external-address“ and press „Save“
Without this registration you will get an error message like „The token URL
or xdReceiver has not been whitelisted“

(6) Proceed to Deployment  Sign-in for Web
and change the „Layout“ or select the „Providers“

Done – enjoy!
Regards, Martin


*For the 5th edition of the book?*

13858  -url = http://localhost:8000/%s/default/user/login; %
request.application)
13858  -url = http://your-external-address/%s/default/user/login; %
request.application)
13861  -The first line imports the new login method, the second line
disables local registration, and the third line asks web2py to use the RPX
login method. You must insert your own ``api_key`` provided by Janrain.com,
the domain you choose upon registration and the external ``url`` of your
login page.
13861  +The first line imports the new login method, the second line
disables local registration, and the third line asks web2py to use the RPX
login method.
13862  +
13863  +-
13864  +Login at janrain.com and go to Deployment  Application Settings.
On the right side there is the Application Info: The ``api_key``  is
called API Key (Secret).
The ``domain`` is the Application Domain *without leading *``https://``
and *without the trailing *``.rpxnow.com/``
13865 +
13866 +For example: if you have registered a website like ``
secure.mywebsite.org`` Janrain has turned it to the Application Domain ``
https://secure-mywebsite.rpxnow.com``. Please insert only
``secure-mywebsite`` as ``domain``. The ``url`` is the external url of your
login page.
13867 +
13868 +Proceed to Deplayment  Application settings  Domain Whitelist. Enter
your-external-address and press Save. Without this registration you will
get an error message like The token URL or xdReceiver has not been
whitelisted
13869 +
13870 +Proceed to Deployment  Sign-in for Web and change the ``Layout`` or
select the ``Providers``
13871 +-

-- 





[web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-01-27 Thread greaneym



 Thanks for the wonderful web2py. Here are some spelling errors that I 
 found in

 the diff download.


 +As soon as you type something in the search box and release a key, the 
 client calls the server and sends the content of the 'keyword' field, and, 
 when the sever responds, the response is embedded in the page itself as the 
 innerHTML of the 'target' tag.   {when the server responds



 +yet this representation in internationalized and you can use the admin 
 stranslation page to change the format to an alternate one. For example:


 looks like stranslation shoud be translation}}}



 +Mind that by default English is not translated because web2py assumes 
 the applications is already written in English. If you want 
 internationalization to work for English you need to create the translation 
 file (using admin) and you need declare that the application current 
 language is something other than english, for example:


 assumes the applications are already written}}



 +Then choose a slug (in the publishing business, a slug is a short name 
 given to an article that is in production) and you will be redirected to an 
 empty page where you can edit the content using MARKMIN wiki syntax. A new 
 menu item called [wiki] will allow you create, search, and edit pages. 
 Wiki pages have RULS like:

 + RULS should be URLS?}



 Try create more pages such as index, aboutus, and contactus.

 +Try edit them.


 {{{ Try to createTry to edit them. }}}



 +- ``render`` which defaults to ``'markmin'`` but can be set equal to 
 ``'html'``. It termines the syntax of the wiki. We will discuss the markmin 
 wiki markup later. If you change it to HTML you may want to use a wysiwyg 
 javascript editor such as TinyMCE of NicEdit.

 {{{ It determines the syntax}}}


 +- ``manage_permissions``. This is set to ``False`` by default and only 
 recognizes permissions for wiki-editor and wiki-author. If you change 
 it to ``True`` the create/edit page will give the option to specify by 
 names the groups whose members have permission to read and edit the page. 
 In this case is a group everybody to give read permission to everybody.


 {{ please eix this last sentence, In this case is a group which does 
 not make sense.}}}



 +- ``restrict_search``. This default to ``False`` and any logged-in user 
 can search all wiki pages (but not necessary read or edit them). If set to 
 ``True``, authors can search only their own pages, editors can search 
 everything, other users cannot search anything.


 {{{ This defaults}}}



 +This call the join function passed as extra with parameters 
 ``a,b,c=1,2,3`` and will be rendered as ``1-2-3``.


 {{{This calls the join }}


 +Mind that the menu is appended to ``response.menu``. It does not replace 
 it. The ``[wiki]`` menu tem with service functions is added automatically.

 +


   menu item with service } 


 +Also, by setting resolve to ``False`` in the method call, the wiki 
 tables will be now accesible trough the app's default db interface at 
 ``app/appadmin`` for managing wiki records.


 {{{accessible through the app's }}}


 i+This allows the visitor interact with the component via Ajax without 
 reloading the host page that embeds the widget. Basically the action is 
 called via Ajax, inherits the stile of the host page, and capture all forms 
 submissions and flash messages so that they are handled within the current 
 page. On top of this the ``SQLFORM.grid`` widget uses digitally signed URLs 
 to restrict access. More information about components can be found in 
 chapter 13.


 {{inherits the style of the host }}}


 +This simply tells web2py that we want to incude the manage_things 
 action defined in the default controller as an Ajax component.


  we want to include the }}}


 +Notice that the admin application includes plugin_jqmodile which 
 packages jQuery Mobile. When admin is accessed from a mobile device; 


 {{{ includes plugin_jqmodule }}}


 +- ``response._caller``: this is a function that wraps all action calls. 
 It defaults to the identity function, but it can be modifed in order to 
 catch special types of exception to do extra logging;

 +  ``


  it can be modified in 



I will read some more this evening.

 

-- 





[web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-01-26 Thread Rufus


On Sunday, January 20, 2013 6:52:02 PM UTC-5, Massimo Di Pierro wrote:

 I am looking for help proofreading the final version of the book. It is 
 almost done up to a final touch. 


Would have loved to help, but didn't see this until late last night (due to 
laptop software migrations...)

Just a couple minor suggestions in the part I had time to read, mostly just 
a matter of personal taste and how
the sentences scanned for me, as a native english speaker.

 from:
If you benefit from it, we hope you will feel a little more like 
contributing back to society in whatever form you choose.
to:
If you benefit from it, we hope you will feel encouraged to ''pay it 
forward'' by contributing back to society in whatever form you choose.

from:
+web2py leaves little choice to application developers in matters related 
to security.
to:
+web2py leaves little exposure for applications in matters related to 
security.

from:
+Experimentally we support more databases.
to:
+We support additional databases (experimentally), and additional ones are 
constantly being developed.

from:
+Once one or more database tables are defined, web2py also generates a 
fully functional web-based database
to:
+Once one or more database tables are defined, web2py automatically 
generates a fully functional web-based database

from:
+web2py provides a ticketing system. If an error occurs, a ticket is issued 
to the user,
to:
+web2py provides a ticketing system for error events. If an error occurs, a 
ticket is issued to the user,

from:
+Another feature of web2py is that we, its developers, commit to maintain 
backward compatibility in future versions.
to:
+Another important feature of web2py is that we, its developers, commit to 
maintain backward compatibility in future versions.

Mostly quite minor, but there it is.

Keep up the excellent work, and I'm ready to buy the next copy as soon as 
it's available!

Rufus

-- 





[web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-01-26 Thread Alan Etkin
 from:
 +web2py leaves little choice to application developers in matters related 
to security.
 to:
 +web2py leaves little exposure for applications in matters related to 
security.

Hi Rufus. IMHO I think the two sentences have different meanings. The 
second, in my opinion, implies in some way that there might be known 
security exposures that were not adressed by the software, while the first 
emphasizes the fact that web2py prevents a user to implement insecure 
features.

-- 





Re: [web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-01-26 Thread Bruno Rocha
I think both are bad! specially by the fact that the largest web2py
audience is not native English speaker, this kind of sentence should be
more explicit.

web2py takes care of main security issues, so developers have little...

-- 





Re: [web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-01-26 Thread Martin Weissenboeck
Some hours ago I have tried to use the PGP Encryption (Chapter 8.1.2)
I have found that the line from gpgme import pgp should be replaced with
something like mail.settings.gpg_home = '/home/www-data/.gnupg/'.

Maybe the following lines could help (sorry, English is not my mother
tongue):

-It is possible to send PGP encrypted emails using the following settings:
+It is possible to send PGP encrypted emails. Install the python-pyme
package.
+Use GPG to create the key-files for the sender (take the email-address
+from mail.settings.sender) and put the files pubring.gpg and
+secring.gpg in a directory (e.g. /home/www-data/.gnupg).
+Use the following settings:
+``
-from gpgme import pgp
+mail.settings.gpg_home = '/home/www-data/.gnupg/'

+mail.settings.cipher_type = 'gpg'
+mail.settings.sign = True
+mail.settings.sign_passphrase = 'your passphrase'
+mail.settings.encrypt = True
+``:code

Regards, Martin

-- 





Re: [web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-01-26 Thread Massimo Di Pierro
Thank you this helps.

On Saturday, 26 January 2013 12:40:18 UTC-6, mweissen wrote:

 Some hours ago I have tried to use the PGP Encryption (Chapter 8.1.2)
 I have found that the line from gpgme import pgp should be replaced 
 with something like mail.settings.gpg_home = '/home/www-data/.gnupg/'.

 Maybe the following lines could help (sorry, English is not my mother 
 tongue):

 -It is possible to send PGP encrypted emails using the following settings:
 +It is possible to send PGP encrypted emails. Install the python-pyme 
 package.
 +Use GPG to create the key-files for the sender (take the email-address
 +from mail.settings.sender) and put the files pubring.gpg and 
 +secring.gpg in a directory (e.g. /home/www-data/.gnupg).
 +Use the following settings:
 +``
 -from gpgme import pgp
 +mail.settings.gpg_home = '/home/www-data/.gnupg/'

 +mail.settings.cipher_type = 'gpg'
 +mail.settings.sign = True
 +mail.settings.sign_passphrase = 'your passphrase'
 +mail.settings.encrypt = True
 +``:code

 Regards, Martin


-- 





Re: [web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-01-26 Thread Rufus


On Saturday, January 26, 2013 12:25:41 PM UTC-5, rochacbruno wrote:

 I think both are bad! specially by the fact that the largest web2py 
 audience is not native English speaker, this kind of sentence should be 
 more explicit.

 web2py takes care of main security issues, so developers have little...


+1 Bruno.
 

-- 





[web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-01-25 Thread Andrew W
I won't get it done before Saturday, but here's one:
replace the first http://code.google.com/p/instant-press/;
with
https://github.com/rochacbruno/Movuca;


On Tuesday, January 22, 2013 1:29:25 AM UTC+13, dhmorgan wrote:

 Signed, I hope! 

 I just downloaded diff and am looking forward to the task. 


-- 





[web2py] Re: looking for volunteers to help proof-read book 5th ed.

2013-01-21 Thread Alan Etkin


 The attached file contains the changes between the 4th edition and 5th 
 edition (only the new text). 


The imap adapter has two new features that could be updated in the email 
section (faster queries by field and override mailbox name mapping).

--